Reference
Arcane.app.current()
Gets the exact bound application descriptor. Its version is owned by arcane-package.json for an Arcane-owned source app or by the authenticated normalized descriptor in arcane-external-apps.lock.json for a source-free external app; built-in Shell and Provisioner use the OS bundle version. Android returns the immutable Shell or application-APK identity with unverified publisher status.
This focused page is derived from the mechanically checked full member inventory.
Syntax
Arcane.app.current()
Parameters
None
Return value
Promise<app record>
Description
Gets the exact bound application descriptor. Its version is owned by arcane-package.json for an Arcane-owned source app or by the authenticated normalized descriptor in arcane-external-apps.lock.json for a source-free external app; built-in Shell and Provisioner use the OS bundle version. Android returns the immutable Shell or application-APK identity with unverified publisher status.
Overview
Arcane.app.current() identifies the application to which the native bridge
session is bound. The host, not renderer input, selects this identity. Use it
for display and correlation; app-scoped storage and authority are already bound
by the host and cannot be changed by passing another id.
The method takes no parameters, is a repeatable read, requires no capability, and is admitted on Core and Android hosts. It has no side effect and emits no event.
Result
The exact result has these eight properties:
| Property | Contract |
|---|---|
id |
Canonical lower-case application id, at most 64 characters. |
displayName |
Host-bound display name. |
type |
"app", "shell", or "provisioner". |
entry |
Safe relative entry path, or null. |
version |
The bound application's semantic version. Shell and Provisioner use the OS bundle version; packaged apps own their version. |
securityMode |
"publisher-verified", "unsigned-local-test", or "unverified". |
publisherTrustSource |
Publisher evidence for a publisher-verified host, otherwise null. |
revocationStatus |
Revocation evidence for a publisher-verified host, otherwise null. |
Android returns the immutable Shell or application-APK descriptor with
securityMode: "unverified" and both publisher evidence fields set to null.
That describes the current Android distribution; it is not a publisher-trust
claim.
Errors and recovery
ARCANE_TRANSPORT_UNAVAILABLE means the page is not running through an Arcane
host. METHOD_CONTRACT_OUTPUT_INVALID means the host supplied an invalid
identity; stop and repair or reinstall the matching host/package rather than
guessing an application id.
Example
const currentApp = await Arcane.app.current();
console.log(currentApp.displayName, currentApp.version);
console.log(currentApp.id, currentApp.type, currentApp.securityMode);