AudioWorklet: port
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Web Audio API")}}{{SeeCompatTable}}
The **port** read-only property of the {{domxref("AudioWorklet")}} interface returns a {{domxref("MessagePort")}} object that can be used to send and receive messages between the main thread and the associated {{domxref("AudioWorkletGlobalScope")}}.
This allows for custom, asynchronous communication between code in the main thread and the global scope of an audio worklet, such as receiving control data or global settings.
Value
The {{domxref("MessagePort")}} object connecting the AudioWorklet and its associated AudioWorkletGlobalScope.
Examples
See [AudioWorkletNode.port](/en-US/docs/Web/API/AudioWorkletNode/port#examples) for more examples.
Using a port for global messages
In the following example, we can use port.onmessage to receive data and port.postMessage to send data:
const context = new AudioContext();
// Load the module that contains worklet code
await context.audioWorklet.addModule("processor.js");
// Listener for messages from AudioWorkletGlobalScope
context.audioWorklet.port.onmessage = (event) => {
console.log("Message from global worklet:", event.data);
};
// Set a global config, for example:
context.audioWorklet.port.postMessage({
volume: 0.8,
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("AudioWorkletGlobalScope")}} — the global execution context of an
AudioWorklet - Web Audio API
- Using the Web Audio API
- Using AudioWorklet