Lock: name-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die name-Schreibgeschützte Eigenschaft des Lock-Interfaces gibt den Name zurück, der an LockManager.request übergeben wurde, als das Lock angefordert wurde.

Der Name eines Locks wird durch ein Skript beim Anfordern des Locks übergeben. Der Name wird vom Entwickler ausgewählt, um eine abstrakte Ressource darzustellen, deren Nutzung über mehrere Tabs, Worker oder anderem Code innerhalb derselben Origin koordiniert wird. Beispielsweise, wenn nur ein Tab einer Webanwendung Netzwerkressourcen mit einer Offline-Datenbank synchronisieren sollte, könnte es einen Lock-Namen wie "net_db_sync" verwenden.

Wert

Ein String.

Beispiele

Die folgenden Beispiele zeigen, wie die name-Eigenschaft während des Aufrufs von LockManager.request() übergeben wird. LockManager ist das Objekt, das von navigator.locks zurückgegeben wird.

js
navigator.locks.request("net_db_sync", show_lock_properties);

function show_lock_properties(lock) {
  console.log(`The lock name is: ${lock.name}`);
  console.log(`The lock mode is: ${lock.mode}`);
}

Spezifikationen

Specification
Web Locks API
# dom-lock-name

Browser-Kompatibilität

BCD tables only load in the browser