AudioWorkletNode: processorerror-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das processorerror-Ereignis wird ausgelöst, wenn der dem Knoten zugrunde liegende AudioWorkletProcessor in seinem Konstruktor, in der Methode process oder in einer benutzerdefinierten Klassenmethode eine Ausnahme auslöst.
Sobald eine Ausnahme ausgelöst wurde, geben der Prozessor und damit auch der Knoten für ihre gesamte verbleibende Lebensdauer Stille aus.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("processorerror", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onprocessorerror = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Damit Sie benachrichtigt werden, wenn der Prozessor eine Ausnahme auslöst, können Sie Ihrer AudioWorkletNode-Instanz mit addEventListener() einen Event-Handler hinzufügen:
whiteNoiseNode.addEventListener("processorerror", (event) => {
console.error("There was an error!");
});
Alternativ können Sie über die Event-Handler-Eigenschaft onprocessorerror einen Event-Handler für das processorerror-Ereignis festlegen. Beachten Sie jedoch, dass dadurch ein zuvor über onprocessorerror festgelegter Event-Handler ersetzt wird:
whiteNoiseNode.onprocessorerror = (event) => {
console.error("There was an error!");
};
Spezifikationen
| Spezifikation |
|---|
| Web Audio API # dom-audioworkletnode-onprocessorerror |