Hash
HTTL
Retrieves the remaining time-to-live (TTL) for field(s) in a hash in seconds.
Arguments
keybodystringrequired
The key of the hash.
fieldsbodystring | number | (string | number)[]required
The field(s) to retrieve the TTL for.
Response
number[]required
The remaining TTL in seconds for each field.
-2if the field does not exist in the hash or if the key doesn't exist.-1if the field exists but has no associated expiration.
For more details, see HTTL documentation.
Example
await redis.hset("my-key", "my-field", "my-value");await redis.hexpire("my-key", "my-field", 10);const ttl = await redis.httl("my-key", "my-field");console.log(ttl); // e.g., [9]