Paginator
An instance of this class is returned in every action that requests an endpoint that implements pagination, simplifying the construction and parsing of Range and Content-Range headers.
Properties
| Property | Type | Description |
|---|---|---|
currentPage |
Number | The current page, considering the pagination size |
headers |
Object | Headers of the current page response |
items |
Array | Current page items |
itemsCount |
Number | Current page items count |
itemsPerPage |
Number | Pagination size |
options |
Object | Options passed to .api() method |
pagesCount |
Number | Number of pages |
sdk |
SDK | SDK instance |
uri |
String | Resource URI |
NOTE: The options property will be passed in any .getPage(), .getNextPage() and .getPreviousPage() methods to the underlying .api() call behind the hood, although you can override it in each of these methods or any other action that resolves a Paginator instance.
Constructor
| Argument | Type | Required | Description |
|---|---|---|---|
sdk |
SDK | Yes | SDK instance |
uri |
String | Yes | Resource URI |
itemsPerPage |
Number | Yes | Pagination size |
options |
Object | No | Options passed to the .api() method |
Methods
.getNextPage()
Resolves a Paginator instance for the next page or undefined if non-existent.
| Argument | Type | Required | Description |
|---|---|---|---|
options |
Object | No | Any options you may want to pass to .api() |
This method returns a Promise.
.getPreviousPage()
Resolves a Paginator instance for the previous page or undefined if non-existent.
| Argument | Type | Required | Description |
|---|---|---|---|
options |
Object | No | Any options you may want to pass to .api() |
This method returns a Promise.
.hasNextPage()
Determines whether or not there is a next page.
.hasPreviousPage()
Determines whether or not there is a previous page.
.getPage()
Resolves a Paginator instance for a specific page or undefined if non-existent.
| Argument | Type | Required | Default | Description | |
|---|---|---|---|---|---|
page |
Number | No | 1 |
Page number to request | |
options |
Object | No | Any options you may want to pass to .api() |
This method returns a Promise.