WorkletSharedStorage: remainingBudget()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die remainingBudget()-Methode des WorkletSharedStorage-Interfaces gibt das verbleibende Navigationsbudget für den aktuellen Ursprung zurück.

Das Navigationsbudget ist die Anzahl der zulässigen Entropiebits innerhalb eines <fencedframe> aufgrund der WindowSharedStorage.selectURL()-Aufrufe pro Ursprung alle 24 Stunden. Dies entspricht nicht der Anzahl der Navigationen, sondern basiert auf der Anzahl der potenziellen Navigationen in jedem Aufruf. Jedes Mal, wenn eine selectURL()-Navigation erfolgt, verringert sich das Budget des entsprechenden Ursprungs um den Logarithmus (zur Basis 2) der Anzahl der URL-Auswahlmöglichkeiten.

Das Navigationsbudget ist ein Mechanismus, der entwickelt wurde, um die Rate des Lecks von Cross-Site-Daten zu den Zielseiten, zu denen in fenced frames navigiert wird, zu begrenzen.

Syntax

js
remainingBudget()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einer Zahl erfüllt wird, die das verbleibende Navigationsbudget darstellt.

Ausnahmen

TypeError

Wird ausgelöst, wenn das Worklet-Modul noch nicht mit addModule() hinzugefügt wurde oder wenn die aufrufende Stelle die Shared Storage API nicht in einem erfolgreichen Datenschutz-Sandbox-Registrierungsprozess eingeschlossen hat.

Beispiele

js
// remainingBudget() available inside a shared storage worklet module

async function retrieveBudget() {
  const budget = await this.sharedStorage.remainingBudget();
  console.log(budget);
}

Spezifikationen

Specification
Shared Storage API
# dom-workletsharedstorage-remainingbudget

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch