cloneInto()

Diese Funktion bietet eine sichere Möglichkeit, ein Objekt, das in einem privilegierten Bereich definiert ist, zu nehmen und einen strukturierter Clone davon in einem weniger privilegierten Bereich zu erstellen. Sie gibt eine Referenz auf den Klon zurück:

var clonedObject = cloneInto(myObject, targetWindow);

Sie können dann den Klon einem Objekt im Zielbereich als expando-Eigenschaft zuweisen, und Skripte, die in diesem Bereich ausgeführt werden, können darauf zugreifen:

targetWindow.foo = clonedObject;

Dies ermöglicht es privilegiertem Code, wie beispielsweise einer Erweiterung, ein Objekt mit weniger privilegiertem Code zu teilen, wie zum Beispiel einem Skript auf einer Webseite.

Syntax

let clonedObject = cloneInto(
  obj,               // object
  targetScope,       // object
  options            // optional object
);

Parameter

obj

object. Das zu klonende Objekt.

targetScope

object. Das Objekt, an das das Objekt angehängt werden soll.

options Optional

object. Optionen für die Funktion.

cloneFunctions Optional: boolean. Ob die Funktionen des Objekts geklont werden sollen. Standardmäßig false. Geklonte Funktionen haben die gleichen Bedeutungen wie Funktionen, die mit exportFunction exportiert wurden. Siehe Klonen von Objekten, die Funktionen enthalten. Optional
wrapReflectors Optional: boolean. Ob DOM-Objekte per Referenz anstatt geklont werden sollen. DOM-Objekte sind normalerweise nicht klonbar. Standardmäßig false. Siehe Klonen von Objekten, die DOM-Elemente enthalten.

Rückgabewert

Eine Referenz auf das geklonte Objekt.

Beispiele

Dieses Contentskript erstellt ein Objekt, klont es in das Inhaltsfenster und macht es zu einer Eigenschaft des globalen Inhaltsfensters:

// content script
var addonScriptObject = { greeting: "hello from your extension" };
window.addonScriptObject = cloneInto(addonScriptObject, window);

Skripte, die auf der Seite laufen, können auf das Objekt zugreifen:

// page script
button.addEventListener(
  "click",
  function () {
    console.log(window.addonScriptObject.greeting); // "hello from your extension"
  },
  false,
);

Natürlich müssen Sie den Klon nicht dem Fenster selbst zuweisen; Sie können ihn auch einem anderen Objekt im Zielbereich zuweisen:

// Content script
window.foo.addonScriptObject = cloneInto(addonScriptObject, window);

Sie können es auch in eine Funktion übergeben, die im Seitenskript definiert ist. Angenommen, das Seitenskript definiert eine Funktion wie folgt:

// page script
function foo(greeting) {
  console.log(`they said: ${greeting.message}`);
}

Das Contentskript kann ein Objekt definieren, es klonen und an diese Funktion übergeben:

// content script
var addonScriptObject = { message: "hello from your extension" };
window.foo(cloneInto(addonScriptObject, window)); // "they said: hello from your extension"

Klonen von Objekten, die Funktionen enthalten

Wenn das zu klonende Objekt Funktionen enthält, müssen Sie das {cloneFunctions:true}-Flag übergeben, sonst erhalten Sie einen Fehler. Wenn Sie dieses Flag übergeben, werden die Funktionen im Objekt mit dem gleichen Mechanismus geklont, der in exportFunction verwendet wird:

// content script
var addonScriptObject = {
  greetMe: function () {
    alert("hello from your extension");
  },
};
window.addonScriptObject = cloneInto(addonScriptObject, window, {
  cloneFunctions: true,
});

// page script
var test = document.getElementById("test");
test.addEventListener(
  "click",
  function () {
    window.addonScriptObject.greetMe();
  },
  false,
);

Klonen von Objekten, die DOM-Elemente enthalten

Standardmäßig, wenn das Objekt, das Sie klonen, Objekte enthält, die von C++ reflektiert werden, wie DOM-Elemente, schlägt der Klonvorgang mit einem Fehler fehl. Wenn Sie das {wrapReflectors:true}-Flag übergeben, enthält das geklonte Objekt diese Objekte:

// content script
var addonScriptObject = {
  body: window.document.body,
};
window.addonScriptObject = cloneInto(addonScriptObject, window, {
  wrapReflectors: true,
});

// page script
var test = document.getElementById("test");
test.addEventListener(
  "click",
  function () {
    console.log(window.addonScriptObject.body.innerHTML);
  },
  false,
);

Der Zugriff auf diese Objekte im Zielbereich unterliegt den normalen Skriptsicherheitsüberprüfungen.