fix(pagination): Explain what happens when cursor does not exist

closes prisma/prisma#14283
prisma · Oct 29, 2023 · 702faf9 · 702faf9
1 parent 34eac16
commit 702faf9
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/content/200-concepts/100-components/02-prisma-client/055-pagination.mdx b/content/200-concepts/100-components/02-prisma-client/055-pagination.mdx
@@ -158,6 +158,10 @@ If you guess the value of the next cursor, you will page to an unknown location
 
 No, cursor pagination does not use cursors in the underlying database ([e.g. PostgreSQL](https://www.postgresql.org/docs/9.2/plpgsql-cursors.html)).
 
+#### What happens if the cursor value does not exist?
+
+Using a nonexistent cursor returns `null`. Prisma does not locate adjacent values.
+
 ### ✔ Pros of cursor-based pagination
 
 - Cursor-based pagination **scales**. The underlying SQL does not use `OFFSET`, but instead queries all `Post` records with an ID greater than the value of `cursor`.