Saves the current item and moves to the next item.
The next()
function returns a Promise that is resolved to the next item
when:
Calling next()
on a write-only dataset causes the
Promise to reject.
If the dataset is read-write, the current item is saved even if there is no next item.
Notes:
A dataset needs to load its data before you call its next()
function.
Usually a dataset finishes loading a short time after the page it is on finishes loading. So if you call next()
inside the page’s onReady()
event handler, the dataset might not be ready yet.
To call next()
as soon as possible after a page loads, use the dataset's onReady()
function inside the page’s onReady()
event handler to ensure that both the page and the dataset have finished loading.
When using a read-write dataset and linked input elements, calling any of the following functions will save any changes made in the linked input elements.