grove.secrets.application.delete()

Delete an application Keychain value.

Signature

grove.secrets.application.delete(key: string): Promise<null>

Availability

All packaged runtimes with storage.secure, including settings pages. The storage capability for persistent browser data is separate.

Parameters

Parameter	Required	Description
`key`	Yes	Nonempty key after trimming surrounding whitespace, at most 200 characters, no control characters.

Return value

Resolves to null after the Keychain operation succeeds.

Behavior and errors

The namespace is isolated by extension identifier and shared across every network instance of that extension. It also matches the default namespace when grove.info.networkID is empty. Deleting a missing key succeeds. Missing grants, invalid keys/values, and Keychain failures reject with Error. Handle failures without logging credentials. Uninstall removes the extension’s secret namespaces; these methods do not access Mango’s own network passwords.

Example

try {
  await grove.secrets.application.delete('service-session')
} catch {
  console.error('Could not remove the service session.')
}

See Storage and settings.