Calculateur d’offset et de limite de pagination

Indiquez la page demandée, le nombre maximal d’enregistrements par page et le nombre total d’éléments disponibles. Le calculateur renvoie l’offset commençant à zéro, la limite de la requête et le nombre total de pages. Il refuse également les numéros ou tailles de page inférieurs à un, afin d’éviter les requêtes de base de données incorrectes et les commandes de navigation incohérentes.

Transformez une page demandée en paramètres de requête

Les interfaces présentent généralement la pagination avec des numéros compréhensibles, tandis que les bases de données et les API attendent souvent un offset commençant à zéro et une limite. Ce calculateur relie ces deux conventions. Saisissez un numéro de page à partir de un, une taille de page et le nombre d’éléments de la collection complète. L’offset correspond au numéro de page diminué de un, puis multiplié par la taille. La limite est simplement la taille de page. Ainsi, la troisième page d’une collection affichée par groupes de vingt-cinq commence après les cinquante premiers éléments : son offset vaut cinquante et sa limite vingt-cinq. Vous pouvez transmettre ces valeurs à une clause SQL LIMIT et OFFSET classique ou les associer aux paramètres équivalents d’un autre service. Le résultat est déterministe et aucun enregistrement n’est consulté ni récupéré. Seul le calcul nécessaire à la préparation d’une requête paginée est effectué, ce qui convient aux backends, scripts, tests, documentations et diagnostics.

Interprétez le total des pages et les cas limites

Le nombre total de pages est obtenu en divisant le nombre d’éléments par la taille de page, puis en arrondissant vers le haut. Cet arrondi est essentiel, car une dernière page partiellement remplie reste une page. Avec cent un éléments affichés par groupes de vingt-cinq, quatre pages contiennent cent éléments et une cinquième accueille le dernier. Lorsque le nombre d’éléments est nul, le nombre de pages vaut zéro puisqu’aucune page de résultats n’existe. La page demandée n’est pas automatiquement ramenée dans cette plage. Demander la page dix peut donc produire un offset valide même si la collection ne compte que trois pages. Ce choix est volontaire : le calculateur fournit l’arithmétique, tandis que vous définissez la politique de votre application. Vous pouvez comparer la page demandée à total_pages, puis renvoyer une liste vide, rediriger vers la dernière page ou afficher une réponse indiquant une ressource introuvable. Séparer calcul et politique garantit un résultat prévisible pour les bases de données, services REST et interfaces.

Validez les données avant de construire la requête

page et page_size doivent être des entiers sûrs supérieurs ou égaux à un. Zéro ou une valeur négative romprait la convention des pages commençant à un ou produirait une limite dépourvue de sens ; ces cas entraînent donc une erreur de saisie. total_items doit être un entier sûr positif ou nul, car une collection ne peut contenir un nombre négatif ou fractionnaire d’enregistrements. La vérification des entiers sûrs empêche aussi une perte silencieuse de précision dans JavaScript lors de multiplications très importantes. Si l’offset calculé dépasse la plage sûre, la demande est refusée au lieu de renvoyer un nombre inexact. Ces règles peuvent également protéger la frontière de votre API contre des paramètres incorrects avant qu’ils atteignent l’adaptateur de base de données. La capacité n’effectue aucune requête réseau, ne conserve aucune donnée et n’emploie aucune valeur aléatoire ou temporelle. Une même entrée produit toujours la même sortie. Chaque automatisation par API coûte $0.002 ; le navigateur vous permet de vérifier des exemples pendant la conception ou le dépannage.