Skip to content

ListOptions

Options for Repository.list.

optional contextValues?: ContextValues

Advanced: reuse an existing context bag for a nested repository call. When omitted, the repository creates a fresh bag for this operation.


optional orderBy?: string

An AIP-132 order_by string (e.g. "age desc, display_name"). Fields are validated against the proto schema.


optional pageSize?: number

Maximum number of results to return per page. Clamped to the repository’s maxSize. Defaults to defaultSize.


optional pageToken?: PageToken

A PageToken for offset-based pagination. Obtain this by calling parse() from @protoutil/aip/pagination on the raw page token string from the client request.


optional readMask?: FieldMask

A FieldMask controlling which fields are returned. Overrides the repository’s default read mask. Defaults to "*".


optional showTotalSize?: boolean

When true, the result includes a totalSize field with the total number of matching resources (before pagination).


optional transaction?: Engine

Run the operation within a transaction.