Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Übertragbare Objekte
Übertragbare Objekte sind Objekte, die Ressourcen besitzen, die von einem Kontext in einen anderenübertragen werden können. Dies stellt sicher, dass die Ressourcen jeweils nur in einem Kontext verfügbar sind.Nach einer Übertragung ist das ursprüngliche Objekt nicht mehr verwendbar; es verweist nicht mehr auf die übertragene Ressource, und ein Versuch, das Objekt zu lesen oder zu schreiben, führt zu einer Ausnahme.
Übertragbare Objekte werden häufig verwendet, um Ressourcen zu teilen, die nur sicher einem einzigen JavaScript-Thread gleichzeitig zugänglich gemacht werden können.Zum Beispiel ist einArrayBuffer ein übertragbares Objekt, das einen Speicherblock besitzt.Wenn ein solches Puffer zwischen Threads übertragen wird, wird die zugehörige Speicherressource vom ursprünglichen Puffer getrennt und an das im neuen Thread erstellte Pufferobjekt angehängt.Das Pufferobjekt im ursprünglichen Thread ist nicht mehr verwendbar, da es keine Speicherressource mehr besitzt.
Das Übertragen kann auch genutzt werden, wenn tiefe Kopien von Objekten mitstructuredClone() erstellt werden.Nach dem Klonvorgang werden die übertragenen Ressourcen bewegt, anstatt kopiert zu werden, zu dem geklonten Objekt.
Sowohl fürpostMessage() als auchstructuredClone() müssen übertragene Ressourcen an das Datenobjekt angehängt werden, da sie andernfalls auf der Empfängerseite nicht verfügbar wären, da das übertragbare Array nur angibt, wie bestimmte Ressourcen gesendet werden sollen, jedoch diese nicht tatsächlich sendet (obwohl sie immer getrennt werden würden).
Der Mechanismus, der verwendet wird, um die Ressourcen eines Objekts zu übertragen, hängt vom Objekt ab.Zum Beispiel wird bei der Übertragung einesArrayBuffer zwischen Threads die Speicherressource, auf die es verweist, buchstäblich zwischen Kontexte in einem schnellen und effizienten Zero-Copy-Vorgang verschoben.Andere Objekte können durch Kopieren der zugehörigen Ressource und anschließendes Löschen aus dem alten Kontext übertragen werden.
Nicht alle Objekte sind übertragbar.Eine Liste der übertragbaren Objekte wirdunten bereitgestellt.
Übertragen von Objekten zwischen Threads
Der folgende Code demonstriert, wie Übertragung funktioniert, wenn eine Nachricht von einem Hauptthread zu einemWeb-Worker-Thread gesendet wird.DieUint8Array wird im Worker kopiert (dupliziert), während ihr Puffer übertragen wird.Nach der Übertragung führt jeder Versuch,uInt8Array vom Hauptthread zu lesen oder zu schreiben, zu einem Fehler, aber Sie können immer noch diebyteLength überprüfen, um zu bestätigen, dass sie jetzt null ist.
// Create an 8MB "file" and fill it. 8MB = 1024 * 1024 * 8 Bconst uInt8Array = new Uint8Array(1024 * 1024 * 8).map((v, i) => i);console.log(uInt8Array.byteLength); // 8388608// Transfer the underlying buffer to a workerworker.postMessage(uInt8Array, [uInt8Array.buffer]);console.log(uInt8Array.byteLength); // 0Hinweis:Typisierte Arrays wieInt32Array undUint8Array sindserialisierbar, aber nicht übertragbar.Ihr zugrundeliegender Puffer ist jedoch einArrayBuffer, ein übertragbares Objekt.Wir hättenuInt8Array.buffer im Datenparameter senden können, aber nichtuInt8Array im Transfer-Array.
Übertragen während einer Klonoperation
Der folgende Code zeigt einestructuredClone()-Operation, bei der der zugrunde liegende Puffer vom ursprünglichen Objekt auf den Klon kopiert wird.
const original = new Uint8Array(1024);const clone = structuredClone(original);console.log(original.byteLength); // 1024console.log(clone.byteLength); // 1024original[0] = 1;console.log(clone[0]); // 0// Transferring the Uint8Array would throw an exception as it is not a transferable object// const transferred = structuredClone(original, {transfer: [original]});// We can transfer Uint8Array.buffer.const transferred = structuredClone(original, { transfer: [original.buffer] });console.log(transferred.byteLength); // 1024console.log(transferred[0]); // 1// After transferring Uint8Array.buffer cannot be used.console.log(original.byteLength); // 0Unterstützte Objekte
Schnittstellen, die übertragen werden können, sollten diese Information in ihrer Einführung enthalten.
Einige der Elemente, die laut verschiedenen Spezifikationenübertragen werden können, sind unten aufgelistet (diese Liste ist möglicherweise nicht erschöpfend!):
ArrayBufferAudioDataImageBitmapMediaSourceHandleMediaStreamTrackMessagePortMIDIAccessOffscreenCanvasReadableStreamRTCDataChannelTransformStreamVideoFrameWebTransportReceiveStreamWebTransportSendStreamWritableStream
Hinweis:Übertragbare Objekte sind inWeb IDL-Dateien mit dem Attribut[Transferable] gekennzeichnet.Die Unterstützung durch Browser kann in den jeweiligen Kompatibilitätsinformationen des Objekts durch die Unterfunktiontransferable angegeben werden (sieheRTCDataChannel für ein Beispiel).