chore(release): v0.6.3

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v0.6.3
+
+[compare changes](https://github.com/wxt-dev/wxt/compare/v0.6.2...v0.6.3)
+
+### 🚀 Enhancements
+
+- **client:** Add `block` and `addEventListener` utils to `ContentScriptContext` ([#128](https://github.com/wxt-dev/wxt/pull/128))
+
+### ❤️ Contributors
+
+- Aaron <aaronklinker1@gmail.com>
+
 ## v0.6.2
 
 [compare changes](https://github.com/wxt-dev/wxt/compare/v0.6.1...v0.6.2)

package.json

@@ -1,7 +1,7 @@
 {
   "name": "wxt",
   "type": "module",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Next gen framework for developing web extensions",
   "engines": {
     "node": ">=18.16.0",

src/client/utils/ContentScriptContext.ts

@@ -54,6 +54,23 @@ export class ContentScriptContext extends AbortController {
     return () => this.signal.removeEventListener('abort', cb);
   }
 
+  /**
+   * Return a promise that never resolves. Useful if you have an async function that shouldn't run
+   * after the context is expired.
+   *
+   * @example
+   * const getValueFromStorage = async () => {
+   *   if (ctx.isInvalid) return ctx.block();
+   *
+   *   // ...
+   * }
+   */
+  block<T>(): Promise<T> {
+    return new Promise(() => {
+      // noop
+    });
+  }
+
   /**
    * Wrapper around `window.setInterval` that automatically clears the interval when invalidated.
    */
@@ -105,6 +122,29 @@ export class ContentScriptContext extends AbortController {
     return id;
   }
 
+  /**
+   * Call `target.addEventListener` and remove the event listener when the context is invalidated.
+   *
+   * @example
+   * ctx.addEventListener(window, "mousemove", () => {
+   *   // ...
+   * });
+   * ctx.addEventListener(document, "visibilitychange", () => {
+   *   // ...
+   * });
+   */
+  addEventListener(
+    target: any,
+    type: string,
+    handler: (event: Event) => void,
+    options?: AddEventListenerOptions,
+  ) {
+    target.addEventListener?.(type, handler, options);
+    this.onInvalidated(
+      () => target.removeEventListener?.(type, handler, options),
+    );
+  }
+
   /**
    * Abort the abort controller and execute all `onInvalidated` listeners.
    */