c.l.cladDocs

Pagination

Relay-style forward pagination with first/after and global object identity.

List fields follow the Relay connection spec and paginate forward only with first + after:

query Page($after: String) {
  issues(first: 50, after: $after) {
    edges { cursor node { id ticketNumber } }
    pageInfo { hasNextPage endCursor }
  }
}

Loop until pageInfo.hasNextPage is false, passing the previous pageInfo.endCursor as the next after. Cursors are opaque — do not construct or parse them yourself.

Global object identity

Every major object implements the Node interface with a globally unique opaque id. Refetch any object by id with node, or up to 50 at once with nodes:

query { node(id: "<opaque-id>") { id } }