The close()
method of the MessagePort
interface disconnects the port, so it is no longer active. This stops the flow of messages to that port.
Note: This feature is available in Web Workers.
Syntax
port.close()
Returns
Void.
Parameters
None.
Example
In the following code block, you can see a handleMessage
handler function, run when a message is sent back to this document using EventTarget.addEventListener
.
channel.port1.addEventListener('message', handleMessage, false);
function handleMessage(e) {
para.innerHTML = e.data;
textInput.value = '';
}
channel.port1.start();
You could stop messages being sent at any time using
channel.port1.close();
Specifications
Specification | Status | Comment |
HTML Living StandardThe definition of 'close()' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
close
|
Chrome
Full support 4 |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support 10 |
Opera
Full support 10.6 |
Safari
Full support 5 |
WebView Android
Full support Yes |
Chrome Android
Full support 18 |
Firefox Android
No support No |
Opera Android
Full support 11 |
Safari iOS
Full support 5.1 |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
- No support
- No support
See also
MessagePort.close() by Mozilla Contributors is licensed under CC-BY-SA 2.5.