Befehl script.removePreloadScript

Syntax

/* With required parameters */
{
  "method": "script.removePreloadScript",
  "params": {
    "script": "d4b1a0f6-2a3c-4f7d-9e21-5c6b7a8d9e0f"
  }
}

Parameter

Das Feld params enthält:

script

Eine Zeichenfolge mit der UUID des zu entfernenden Preload-Skripts. Preload-Skript-IDs werden vom Befehl script.addPreloadScript zurückgegeben.

Rückgabewert

Das Feld result in der Antwort ist ein leeres Objekt ({}).

Fehler

invalid argument

Wird ausgelöst, wenn ein erforderlicher Parameter fehlt oder einen ungültigen Typ hat.

no such script

Wird ausgelöst, wenn kein Preload-Skript mit der angegebenen Skript-ID gefunden wird.

Beschreibung

Nachdem ein Preload-Skript entfernt wurde, führt der Browser es in neuen Dokumenten nicht mehr aus. Das Entfernen eines Preload-Skripts macht bereits vorgenommene Änderungen nicht rückgängig.

Wenn eine Sitzung endet, entfernt der Browser automatisch alle in dieser Sitzung registrierten Preload-Skripte.

Beispiele

Ein Preload-Skript entfernen

Vorausgesetzt, Sie haben eine WebDriver-BiDi-Verbindung und eine aktive Sitzung.

Angenommen, Sie haben mit script.addPreloadScript ein Preload-Skript registriert, das die URL jedes neuen Dokuments protokolliert. Der Browser gibt die ID des Preload-Skripts im Feld script zurück.

Um die Protokollierung der URLs neuer Dokumente zu beenden, senden Sie die folgende Nachricht, um das Preload-Skript zu entfernen:

{
  "id": 3,
  "method": "script.removePreloadScript",
  "params": {
    "script": "d4b1a0f6-2a3c-4f7d-9e21-5c6b7a8d9e0f"
  }
}

Der Browser antwortet mit einem leeren result-Objekt:

{
  "id": 3,
  "type": "success",
  "result": {}
}

Wenn Sie anschließend einen Kontext zu einem neuen Dokument navigieren, protokolliert das entfernte Preload-Skript die URL des Dokuments nicht mehr.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Befehl script.addPreloadScript
• Befehl script.evaluate
• Befehl script.callFunction