Removes the current item.
The remove()
function returns a Promise that is resolved
when:
Calling remove()
on a write-only or read-only dataset causes an error.
Note:
A dataset needs to load its data before you call its remove()
function.
Usually a dataset finishes loading a short time after the page it is on finishes
loading. So if you call remove()
inside the page’s onReady()
event handler, the dataset might not be ready yet.
To call remove()
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.