wavesurfer.js 7.12.6 → 7.12.8

package/dist/webaudio.js

@@ -8,6 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import EventEmitter from './event-emitter.js';
+function setWebAudioSessionPlayback() {
+    const navigator = globalThis.navigator;
+    if (!(navigator === null || navigator === void 0 ? void 0 : navigator.audioSession))
+        return;
+    try {
+        navigator.audioSession.type = 'playback';
+    }
+    catch (e) {
+        console.warn('Setting navigator.audioSession.type failed:', e);
+    }
+}
 /**
  * A Web Audio buffer player emulating the behavior of an HTML5 Audio element.
  *
@@ -16,7 +27,7 @@ import EventEmitter from './event-emitter.js';
  * blob URL lifecycle management automatically.
  */
 class WebAudioPlayer extends EventEmitter {
-    constructor(audioContext = new AudioContext()) {
+    constructor(audioContext) {
         super();
         this.bufferNode = null;
         this.playStartTime = 0;
@@ -34,7 +45,9 @@ class WebAudioPlayer extends EventEmitter {
         this.addEventListener = this.on;
         /** Unsubscribe from an event */
         this.removeEventListener = this.un;
-        this.audioContext = audioContext;
+        this._destroyed = false;
+        setWebAudioSessionPlayback();
+        this.audioContext = audioContext || new AudioContext();
         this.gainNode = this.audioContext.createGain();
         this.gainNode.connect(this.audioContext.destination);
     }
@@ -43,6 +56,42 @@ class WebAudioPlayer extends EventEmitter {
             return;
         });
     }
+    /** For compatibility with HTMLMediaElement.remove(). Delegates to destroy(). */
+    remove() {
+        this.destroy();
+    }
+    /** Clean up all resources. Idempotent — safe to call multiple times. */
+    destroy() {
+        if (this._destroyed)
+            return;
+        this._destroyed = true;
+        // Clear currentSrc so any in-flight fetch/decode chains bail out
+        // via their existing `this.currentSrc !== value` guards
+        this.currentSrc = '';
+        // Stop and disconnect buffer node
+        if (this.bufferNode) {
+            this.bufferNode.onended = null;
+            try {
+                this.bufferNode.stop();
+            }
+            catch (_a) {
+                // Ignore InvalidStateError if node already stopped
+            }
+            this.bufferNode.disconnect();
+            this.bufferNode = null;
+        }
+        // Disconnect gain node
+        this.gainNode.disconnect();
+        // Close audio context (returns a promise, catch rejection if already closed)
+        // Guard with typeof check for mock environments where close may not exist
+        if (typeof this.audioContext.close === 'function') {
+            Promise.resolve(this.audioContext.close.call(this.audioContext)).catch(() => undefined);
+        }
+        // Clear buffer reference
+        this.buffer = null;
+        // Clear all event listeners
+        this.unAll();
+    }
     get src() {
         return this.currentSrc;
     }
@@ -103,16 +152,24 @@ class WebAudioPlayer extends EventEmitter {
         this.bufferNode.start(this.audioContext.currentTime, currentPos);
         this.playStartTime = this.audioContext.currentTime;
         this.bufferNode.onended = () => {
-            if (this.currentTime >= this.duration) {
+            if (!this.paused && this.duration - this.currentTime < 0.01) {
                 this.pause();
                 this.emit('ended');
             }
         };
     }
     _pause() {
-        var _a;
         this.paused = true;
-        (_a = this.bufferNode) === null || _a === void 0 ? void 0 : _a.stop();
+        // Clear onended before stopping to prevent spurious 'ended' event
+        if (this.bufferNode) {
+            this.bufferNode.onended = null;
+            try {
+                this.bufferNode.stop();
+            }
+            catch (_a) {
+                // Ignore InvalidStateError if node already stopped
+            }
+        }
         this.playbackPosition += (this.audioContext.currentTime - this.playStartTime) * this._playbackRate;
     }
     play() {
@@ -130,13 +187,19 @@ class WebAudioPlayer extends EventEmitter {
         this.emit('pause');
     }
     stopAt(timeSeconds) {
-        const delay = timeSeconds - this.currentTime;
+        // The stop is scheduled on the AudioContext clock, so convert the remaining
+        // media time to real time via the playback rate
+        const delay = (timeSeconds - this.currentTime) / this._playbackRate;
         const currentBufferNode = this.bufferNode;
         currentBufferNode === null || currentBufferNode === void 0 ? void 0 : currentBufferNode.stop(this.audioContext.currentTime + delay);
         currentBufferNode === null || currentBufferNode === void 0 ? void 0 : currentBufferNode.addEventListener('ended', () => {
             if (currentBufferNode === this.bufferNode) {
                 this.bufferNode = null;
                 this.pause();
+                // The 'ended' event fires with some latency, so clamp the reported
+                // position to the exact stop time
+                this.playbackPosition = Math.min(timeSeconds, this.duration);
+                this.emit('timeupdate');
             }
         }, { once: true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wavesurfer.js",
-  "version": "7.12.6",
+  "version": "7.12.8",
   "license": "BSD-3-Clause",
   "author": "katspaugh",
   "description": "Audio waveform player",
@@ -64,32 +64,33 @@
     "make-plugin": "./scripts/plugin.sh",
     "cypress": "cypress open --e2e",
     "cypress:canary": "cypress open --e2e -b chrome:canary",
-    "test": "cypress run --browser chrome",
+    "test": "cypress run --browser ${CYPRESS_BROWSER:-chromium}",
     "test:unit": "jest --coverage",
     "serve": "npx live-server --port=9090 --no-browser --ignore='.*,src,cypress,scripts'",
     "start": "npm run build:dev & npm run serve",
+    "dev": "npm run start",
     "prepare": "npm run build"
   },
   "packageManager": "yarn@1.22.22",
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.1",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/jest": "^29.5.2",
-    "@typescript-eslint/eslint-plugin": "^8.43.0",
-    "@typescript-eslint/parser": "^8.43.0",
-    "cypress": "^13.16.1",
+    "@typescript-eslint/eslint-plugin": "^8.60.1",
+    "@typescript-eslint/parser": "^8.60.1",
+    "cypress": "^13.17.0",
     "cypress-image-snapshot": "^4.0.1",
-    "eslint": "^9.35.0",
+    "eslint": "^9.39.4",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.2.1",
-    "glob": "^11.0.0",
+    "eslint-plugin-prettier": "^5.5.6",
+    "glob": "^11.1.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "prettier": "^3.4.2",
-    "rollup": "^4.50.1",
-    "rollup-plugin-dts": "^6.1.0",
+    "prettier": "^3.8.3",
+    "rollup": "^4.61.1",
+    "rollup-plugin-dts": "^6.4.1",
     "rollup-plugin-web-worker-loader": "^1.7.0",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.9.2"
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.9.3"
   }
 }