source: imaps-frontend/node_modules/es-abstract/2022/DetachArrayBuffer.js@ d565449

'use strict';

var $SyntaxError = require('es-errors/syntax');
var $TypeError = require('es-errors/type');

var IsDetachedBuffer = require('./IsDetachedBuffer');

var isArrayBuffer = require('is-array-buffer');
var isSharedArrayBuffer = require('is-shared-array-buffer');

var MessageChannel;
try {
        // eslint-disable-next-line global-require
        MessageChannel = require('worker_threads').MessageChannel;
} catch (e) { /**/ }

// https://262.ecma-international.org/9.0/#sec-detacharraybuffer

/* globals postMessage */

module.exports = function DetachArrayBuffer(arrayBuffer) {
        if (!isArrayBuffer(arrayBuffer) || isSharedArrayBuffer(arrayBuffer)) {
                throw new $TypeError('Assertion failed: `arrayBuffer` must be an Object with an [[ArrayBufferData]] internal slot, and not a Shared Array Buffer');
        }

        // commented out since there's no way to set or access this key
        // var key = arguments.length > 1 ? arguments[1] : void undefined;

        // if (!SameValue(arrayBuffer[[ArrayBufferDetachKey]], key)) {
        //      throw new $TypeError('Assertion failed: `key` must be the value of the [[ArrayBufferDetachKey]] internal slot of `arrayBuffer`');
        // }

        if (!IsDetachedBuffer(arrayBuffer)) { // node v21.0.0+ throws when you structuredClone a detached buffer
                if (typeof structuredClone === 'function') {
                        structuredClone(arrayBuffer, { transfer: [arrayBuffer] });
                } else if (typeof postMessage === 'function') {
                        postMessage('', '/', [arrayBuffer]); // TODO: see if this might trigger listeners
                } else if (MessageChannel) {
                        (new MessageChannel()).port1.postMessage(null, [arrayBuffer]);
                } else {
                        throw new $SyntaxError('DetachArrayBuffer is not supported in this environment');
                }
        }

        return null;
};