@webreflection/utils 0.1.0 → 0.1.1

package/README.md

@@ -8,6 +8,9 @@
 A [collection](./src/) of utility functions.
 
 ```js
+// example: a shim based on ArrayBuffer if native is `false`
+import { SharedArrayBuffer, native } from 'https://esm.run/@webreflection/utils/shared-array-buffer';
+
 // example: self bound Promise.withResolvers()
 import withResolvers from 'https://esm.run/@webreflection/utils/with-resolvers';
 

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@webreflection/utils",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "exports": {
+    "./shared-array-buffer": "./src/shared-array-buffer.js",
     "./with-resolvers": "./src/with-resolvers.js",
     "./package.json": "./package.json"
   },
   "tests": [
+    "shared-array-buffer",
     "with-resolvers"
   ],
   "scripts": {

package/src/shared-array-buffer.js

@@ -0,0 +1,28 @@
+//@ts-check
+
+let { SharedArrayBuffer: SAB } = globalThis, native = true;
+
+try {
+  //@ts-ignore due valid options not recognized
+  new SAB(4, { maxByteLength: 8 });
+}
+catch (_) {
+  native = false;
+  SAB = /** @type {SharedArrayBufferConstructor} */(
+    /** @type {unknown} */(
+      class SharedArrayBuffer extends ArrayBuffer {
+        get growable() {
+          //@ts-ignore due valid property not recognized
+          return super.resizable;
+        }
+        /** @param {number} newLength */
+        grow(newLength) {
+          //@ts-ignore due valid method not recognized
+          super.resize(newLength);
+        }
+      }
+    )
+  );
+}
+
+export { SAB as SharedArrayBuffer, native };

package/test/shared-array-buffer.js

@@ -0,0 +1,22 @@
+const { SharedArrayBuffer: SAB } = globalThis;
+
+globalThis.SharedArrayBuffer = null;
+
+const { SharedArrayBuffer, native } = await import("../src/shared-array-buffer.js");
+
+globalThis.SharedArrayBuffer = SAB;
+
+console.assert(!native);
+
+const gsab = new SharedArrayBuffer(4, { maxByteLength: 8 });
+
+console.assert(gsab.byteLength === 4);
+console.assert(gsab.growable);
+
+gsab.grow(8);
+
+console.assert(gsab.byteLength === 8);
+
+const fsab = new SharedArrayBuffer(6);
+console.assert(fsab.byteLength === 6);
+console.assert(!fsab.growable);