@webreflection/utils 0.1.0 → 0.1.2

package/.github/workflows/node.js.yml

@@ -15,7 +15,7 @@ jobs:
         node-version: [22]
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Use Node.js ${{ matrix.node-version }}
       uses: actions/setup-node@v4
       with:

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.2",
   "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/src/with-resolvers.js

@@ -5,8 +5,15 @@
  * @typedef {{promise: Promise<T>, resolve: (value: T) => void, reject: (reason?: any) => void}} Resolvers
  */
 
+// fallback for Android WebView
 //@ts-ignore
-const withResolvers = Promise.withResolvers;
+const withResolvers = Promise.withResolvers || function withResolvers() {
+  var a, b, c = new this((resolve, reject) => {
+    a = resolve;
+    b = reject;
+  });
+  return {resolve: a, reject: b, promise: c};
+};
 
 /**
  * @template T

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);

package/test/with-resolvers.js

@@ -1,4 +1,6 @@
-import withResolvers from '../src/with-resolvers.js';
+Promise.withResolvers = undefined;
+
+const { default: withResolvers } = await import('../src/with-resolvers.js');
 
 const { promise, resolve, reject } = withResolvers();