Visitar URL original
Subjects and events
puter.kv.expireAt()Sets the time a key expires, as a Unix timestamp in seconds.
puter.kv.expireAt(key, timestampSeconds)
puter.kv.expireAt(key, timestampSeconds, optConfig)
key (String) (required)
The key to expire.
timestampSeconds (Number) (required)
The Unix timestamp, in seconds, when the key is removed. Use seconds, not the milliseconds Date.now() returns. A timestamp at or before now, including 0, expires the key right away.
optConfig (Object) (optional)
The last argument. It takes these properties:
handle (String): Works on data another user shared with you, using the handle from puter.kv.listShared(). The key is then relative to the shared prefix, and the share needs write access. See Sharing with other users.appUuid (String): Works on another app's data, which the user let your app reach with puter.perms.request('appData', …). It can't be combined with handle.A Promise that resolves to true once the expiry is set.
With handle, the promise can reject with these codes:
| Code | Meaning |
|---|---|
kv_handle_not_found |
handle doesn't exist, the share stopped, it isn't shared with you, or the call comes from an app other than the one whose data it shares. |
kv_handle_access_denied |
The share's access doesn't allow this method, or the key is private to the owner's app. |
kv_handle_option_invalid |
handle was combined with appUuid. |
kv_handle_key_invalid |
With handle, the key is empty or longer than 768 bytes. |
kv_handles_disabled |
Calls through a share are turned off on this deployment. |
A missing or already-expired key becomes an empty entry with the TTL you gave it, rather than staying absent. puter.kv.list() shows it and puter.kv.get() reads it as null, the same as a missing key. The old value, if there was one, doesn't come back. puter.kv.incr() rejects such an entry, the same as any non-number value.
To remove a key's TTL instead of setting one, use puter.kv.set() or puter.kv.update() with a null TTL.
Retrieve the value of a key after it expires
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
// (1) Create a new key-value pair
await puter.kv.set('name', 'Puter Smith');
puter.print("Key-value pair 'name' created/updated<br>");
// (2) Set key to expire in 1 second
await puter.kv.expireAt('name', Math.floor(Date.now() / 1000) + 1);
// (3) Wait 2 seconds and get the value
setTimeout(async () => {
const name = await puter.kv.get('name');
puter.print(`Value: ${name}`);
}, 2000);
})();
</script>
</body>
</html>