feat: chrome response modifier

Author: sylingd

.github/actions/build-and-test/action.yml

@@ -0,0 +1,48 @@
+name: "Build and Test"
+description: "Build and Test"
+runs:
+  using: "composite"
+  steps:
+    - name: Build Firefox v2
+      shell: bash
+      run: npm run build:firefox_v2
+    - name: Build Firefox v3
+      shell: bash
+      run: npm run build:firefox_v3
+    - name: Build Chrome v2
+      shell: bash
+      run: npm run build:chrome_v2
+    - name: Build Chrome v3
+      shell: bash
+      run: npm run build:chrome_v3
+    - name: Upload bundle
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        retention-days: 7
+        path: |
+          dist_chrome_v2
+          dist_chrome_v3
+          dist_firefox_v2
+          dist_firefox_v3
+    - name: Install Edge
+      id: install-edge
+      shell: bash
+      run: |
+        sudo apt-get remove -y microsoft-edge-stable
+        sudo wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/microsoft.gpg
+        sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main"
+        sudo apt-get update
+        sudo apt-get install -y microsoft-edge-stable=138.0.3351.109-1
+        microsoft-edge --version
+        EDGE_PATH=$(which microsoft-edge)
+        echo "edge-path=$EDGE_PATH" >> $GITHUB_OUTPUT
+    - name: Test
+      shell: bash
+      env:
+        EDGE_PATH: ${{ steps.install-edge.outputs.edge-path }}
+      run: |
+        npx puppeteer browsers install
+        php -S 0.0.0.0:8899 -t $GITHUB_WORKSPACE/tests/simple-server > /dev/null 2>&1 &
+        sleep 2
+        npm run test:e2e

.github/workflows/dev.yml

@@ -4,6 +4,16 @@ on:
   push:
     branches:
     - dev
+  workflow_dispatch:
+    inputs:
+      platform:
+        description: 'Platform(amo,cws,xpi,edge,crx)'
+        required: true
+        type: string
+      version:
+        description: 'Version'
+        required: true
+        type: string
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -41,16 +51,20 @@ jobs:
   build:
     needs: check_changes
     runs-on: ubuntu-24.04
-    if: ${{ needs.check_changes.outputs.src_changed == 'true' }}
+    if: ${{ needs.check_changes.outputs.src_changed == 'true' || github.event_name == 'workflow_dispatch' }}
     steps:
     - uses: actions/checkout@v4
+    - name: Inject Env
+      run: |
+        echo "INPUT_PLATFORM=${{ github.event.inputs.platform }}" >> $GITHUB_ENV
+        echo "INPUT_VERSION=${{ github.event.inputs.version }}" >> $GITHUB_ENV
     - uses: pnpm/action-setup@v4
       with:
         version: 9
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 18
+        node-version: 20
         cache: 'pnpm'
     - name: Install dependencies
       run: pnpm i --frozen-lockfile
@@ -59,58 +73,22 @@ jobs:
         TOKEN: ${{ secrets.SNAPSHOT_TOKEN }}
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: node ./scripts/get-snapshot-version.mjs
-    - name: Build Firefox v2
-      run: npm run build:firefox_v2
-    - name: Build Firefox v3
-      run: npm run build:firefox_v3
-    - name: Build Chrome v2
-      run: npm run build:chrome_v2
-    - name: Build Chrome v3
-      run: npm run build:chrome_v3
-    - name: Upload bundle
-      uses: actions/upload-artifact@v4
-      with:
-        name: dist
-        retention-days: 7
-        path: |
-          dist_chrome_v2
-          dist_chrome_v3
-          dist_firefox_v2
-          dist_firefox_v3
-    - name: Install Edge
-      id: install-edge
-      run: |
-        sudo apt-get remove -y microsoft-edge-stable
-        sudo wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/microsoft.gpg
-        sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main"
-        sudo apt-get update
-        sudo apt-get install -y microsoft-edge-stable=138.0.3351.109-1
-        microsoft-edge --version
-        EDGE_PATH=$(which microsoft-edge)
-        echo "edge-path=$EDGE_PATH" >> $GITHUB_OUTPUT
-    - name: Test
-      env:
-        EDGE_PATH: ${{ steps.install-edge.outputs.edge-path }}
-      run: |
-        npx puppeteer browsers install
-        php -S 0.0.0.0:8899 -t $GITHUB_WORKSPACE/tests/simple-server &
-        sleep 3
-        npm run test:e2e
+    - name: Build And Test
+      uses: ./.github/actions/build-and-test
     - name: Publish snapshot
       env:
         AMO_KEY: ${{ secrets.AMO_KEY }}
         AMO_SECRET: ${{ secrets.AMO_SECRET }}
         CRX_PRIV_KEY: ${{ secrets.CRX_PRIV_KEY }}
         PACK_PLATFORM: xpi,crx
+        DEBUG: '*'
       run: npm run pack
     - name: Upload snapshot release
       uses: actions/upload-artifact@v4
       with:
         name: release
         retention-days: 7
-        path: |
-          temp/release
-          !temp/release/*-id.txt
+        path: temp/release
 
   sync-locale:
     needs: check_changes
@@ -121,7 +99,7 @@ jobs:
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 18
+        node-version: 20
     - name: Sort
       run: node ./locale/sort-origin.js
     - name: Deploy
@@ -144,7 +122,7 @@ jobs:
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 18
+        node-version: 20
     - name: Install dependencies
       run: |
         cd $GITHUB_WORKSPACE/docs
@@ -158,7 +136,7 @@ jobs:
       uses: actions/upload-artifact@v4
       with:
         name: docs
-        retention-days: 2
+        retention-days: 1
         path: docs/doc_build
 
   deploy-docs-cloudflare:

.github/workflows/main.yml

@@ -38,7 +38,7 @@ jobs:
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 18
+        node-version: 20
     - name: Install dependencies
       run: |
         cd $GITHUB_WORKSPACE/docs
@@ -52,7 +52,7 @@ jobs:
       uses: actions/upload-artifact@v4
       with:
         name: docs
-        retention-days: 2
+        retention-days: 1
         path: docs/doc_build
 
   deploy-docs-cloudflare:

.github/workflows/release.yml

@@ -24,53 +24,22 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
+    - name: Inject Env
+      run: |
+        echo "INPUT_PLATFORM=${{ github.event.inputs.platform }}" >> $GITHUB_ENV
+        echo "INPUT_VERSION=${{ github.event.inputs.version }}" >> $GITHUB_ENV
     - uses: pnpm/action-setup@v4
       with:
         version: 9
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: 18
+        node-version: 20
         cache: 'pnpm'
     - name: Install dependencies
       run: pnpm i --frozen-lockfile
-    - name: Build Firefox v2
-      run: npm run build:firefox_v2
-    - name: Build Firefox v3
-      run: npm run build:firefox_v3
-    - name: Build Chrome v2
-      run: npm run build:chrome_v2
-    - name: Build Chrome v3
-      run: npm run build:chrome_v3
-    - name: Upload bundle
-      uses: actions/upload-artifact@v4
-      with:
-        name: dist
-        retention-days: 7
-        path: |
-          dist_chrome_v2
-          dist_chrome_v3
-          dist_firefox_v2
-          dist_firefox_v3
-    - name: Install Edge
-      id: install-edge
-      run: |
-        sudo apt-get remove -y microsoft-edge-stable
-        sudo wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/microsoft.gpg
-        sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/edge stable main"
-        sudo apt-get update
-        sudo apt-get install -y microsoft-edge-stable=138.0.3351.109-1
-        microsoft-edge --version
-        EDGE_PATH=$(which microsoft-edge)
-        echo "edge-path=$EDGE_PATH" >> $GITHUB_OUTPUT
-    - name: Test
-      env:
-        EDGE_PATH: ${{ steps.install-edge.outputs.edge-path }}
-      run: |
-        npx puppeteer browsers install
-        php -S 0.0.0.0:8899 -t $GITHUB_WORKSPACE/tests/simple-server &
-        sleep 3
-        npm run test:e2e
+    - name: Build And Test
+      uses: ./.github/actions/build-and-test
     - name: Pack
       env:
         AMO_KEY: ${{ secrets.AMO_KEY }}
@@ -82,6 +51,7 @@ jobs:
         CWS_TOKEN: ${{ secrets.CWS_TOKEN }}
         MS_CLIENT_ID: ${{ secrets.MS_CLIENT_ID }}
         MS_API_KEY: ${{ secrets.MS_API_KEY }}
+        DEBUG: '*'
       run: npm run pack
     - name: Upload release
       uses: actions/upload-artifact@v4

README.md

@@ -4,25 +4,28 @@ Header Editor
 
 [![Release](https://img.shields.io/github/release/FirefoxBar/HeaderEditor.svg?label=Release)](https://github.com/FirefoxBar/HeaderEditor/releases)
 [![Chrome Web Store](https://img.shields.io/chrome-web-store/users/eningockdidmgiojffjmkdblpjocbhgh?label=Chrome)](https://chrome.google.com/webstore/detail/header-editor/eningockdidmgiojffjmkdblpjocbhgh)
-[![Mozilla Addons](https://img.shields.io/amo/users/header-editor?label=Firefox)](https://addons.mozilla.org/en-US/firefox/addon/header-editor/)
+[![Mozilla Add-ons](https://img.shields.io/amo/users/header-editor?label=Firefox)](https://addons.mozilla.org/en-US/firefox/addon/header-editor/)
+[![Mozilla Add-ons](https://img.shields.io/amo/users/header-editor-lite?label=Firefox(Lite))](https://addons.mozilla.org/en-US/firefox/addon/header-editor-lite/)
 [![license](https://img.shields.io/github/license/FirefoxBar/HeaderEditor.svg?label=License)](https://github.com/FirefoxBar/HeaderEditor/blob/master/LICENSE)
 [![Discussions](https://img.shields.io/github/discussions/FirefoxBar/HeaderEditor?label=Discussions)](https://github.com/FirefoxBar/HeaderEditor/discussions)
 [![Build Status](https://github.com/FirefoxBar/HeaderEditor/actions/workflows/dev.yml/badge.svg)](https://github.com/FirefoxBar/HeaderEditor/actions/workflows/dev.yml)
 
-An extension which can modify the request, include request headers, response headers, redirect requests, and cancel requests.
+An extension which can modify the request, include request headers, response headers, response body, redirect requests, and cancel requests.
 
 It's 100% FREE, no ADs, no data collection.
 
-For more documentations, Please visit [he.firefoxcn.net](https://he.firefoxcn.net)
+Visit [he.firefoxcn.net](https://he.firefoxcn.net) for more documentations.
 
 ## Get this extension
 
-| Browser | Lite Version | Full Version |
+| Browser | Lite | Full |
 | --- | --- | --- |
-| ![Firefox Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_16x16.png) Firefox | None | [Mozilla Add-on](https://addons.mozilla.org/en-US/firefox/addon/header-editor/) or our [self-distributed version](https://github.com/FirefoxBar/HeaderEditor/releases) |
+| ![Firefox Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_16x16.png) Firefox | [Mozilla Add-ons](https://addons.mozilla.org/en-US/firefox/addon/header-editor-lite/) | [Mozilla Add-ons](https://addons.mozilla.org/en-US/firefox/addon/header-editor/) or our [self-distributed version](https://github.com/FirefoxBar/HeaderEditor/releases) |
 | ![Chrome Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_16x16.png) Chrome | [Chrome Web Store](https://chrome.google.com/webstore/detail/header-editor/eningockdidmgiojffjmkdblpjocbhgh) | [Install full version](https://he.firefoxcn.net/en-US/guide/install-full-version) |
 | ![Edge Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_16x16.png) Edge | None | [Edge Addons](https://microsoftedge.microsoft.com/addons/detail/header-editor/afopnekiinpekooejpchnkgfffaeceko) |
 
+[Diff between Lite and Full Version](https://he.firefoxcn.net/en-US/guide/index.html)
+
 ## Permissions
 
 Header Editor require those permissions:
@@ -33,6 +36,8 @@ Header Editor require those permissions:
 
 * `storage`, `unlimitedStorage`: Storage rules and settings
 
+* `debugger`: Modify response body in Chrome
+
 * `unsafe-eval`: Execute custom function, code at [src/share/core/rule-utils.ts#L30](https://github.com/FirefoxBar/HeaderEditor/blob/dev/src/share/core/rule-utils.ts#L30) (may change in the future, you can search for the newest location by `new Function`)
 
 ## Contribution
@@ -47,13 +52,13 @@ English: Please submit a issue or pull request to file `locale/original/messages
 
 Other language: Please translate them on [Transifex](https://app.transifex.com/sytec/header-editor/)
 
-Please note that some languages (such as zh-Hans) will not be translated on transifex because the browser does not support them, click [here](https://developer.chrome.com/docs/webstore/i18n/#choosing-locales-to-support) to view full list
+Please note that some languages (such as zh-Hans) will not be translated on transifex because the browser does not support them, [view full list](https://developer.chrome.com/docs/webstore/i18n/#choosing-locales-to-support).
 
 ## How to build
 
 ### Build
 
-* Install node (18+) and pnpm.
+* Install Node.js 20.x and pnpm 9.x.
 * Clone this project, or download the source code and extract it.
 * Run `pnpm i --frozen-lockfile`.
 * Run build command
@@ -75,7 +80,7 @@ Please note that some languages (such as zh-Hans) will not be translated on tran
 
 Copyright © 2017-2025 [FirefoxBar Team](https://team.firefoxcn.net)
 
-Open source licensed under [GPLv2](LICENSE).
+This project is licensed under the ​**GNU GPL v2.0 or later**.
 
 ## Technical Sponsorship
 

docs/docs/en-US/guide/FAQ.md

@@ -2,6 +2,31 @@
 title: FAQ
 ---
 
+## "Header Editor" started debugging this browser
+
+On Chrome, you'll see this prompt when the response body modification feature is enabled. If you don't want to see this prompt, you can:
+* Disable "Modify Response Body" in "Options".
+* Add the `--silent-debugger-extension-api` parameter when running Chrome.
+
+## All rules are ineffective
+
+In rare cases, some rules may fail to initialize due to syntax errors, resulting in all rules being ineffective.
+
+In this case, you can find the specific rule and modify or disable it using the following methods:
+
+Chrome:
+* Open `chrome://extensions/?id=eningockdidmgiojffjmkdblpjocbhgh`
+* Enable "Developer Mode" in the upper right corner
+* Click "Service Worker" under "Inspect View"
+* Find the error message and check the ID, corresponding rule, and error message.
+![img](https://img11.360buyimg.com/ddimg/jfs/t1/333577/33/836/91910/68a4ab26F2b85cd64/8d6cd3da3b9af51a.jpg)
+
+Firefox:
+* Open `about:debugging`
+* Find "Header Editor" and click the "Inspect" button on the right.
+* Find the corresponding rule and error message.
+![img](https://img13.360buyimg.com/ddimg/jfs/t1/289605/39/18012/32092/68a4ae2cFa61f9a6a/9be7525f36abe945.jpg)
+
 ## Why is "header name" reduced to lowercase?
 
 [RFC 2616](https://tools.ietf.org/html/rfc2616.html#section-4.2) says:

docs/docs/en-US/guide/cloud-backup.md

@@ -29,6 +29,6 @@ As I know, Chrome has limits on the number of operations per unit of time. It me
 ### Firefox
 
 * It seems that Firefox Sync is executed regularly, however if you want to force the cloud export you've to launch Firefox Sync manually.
-![](https://user-images.githubusercontent.com/886325/41821498-e081fe7e-77e1-11e8-81de-03a09d826cb9.png)
+![](https://img12.360buyimg.com/ddimg/jfs/t1/331038/40/854/2134/68a4ab75Fcd087439/c89009381abc82ea.jpg)
 * A new installation may cause cloud storage data to be blanked.
 * See [browser.storage API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage) for more technical details.

docs/docs/en-US/guide/custom-function.md

@@ -22,7 +22,7 @@ function(val, detail) { // does not include this line
 
 For example:
 
-![image](https://user-images.githubusercontent.com/5326684/54876966-6bd6c480-4e53-11e9-8e9d-6c950f8b5cd2.png)
+![image](https://img13.360buyimg.com/ddimg/jfs/t1/302163/31/25689/8426/68a4ab87Fffa8fbd6/4581fc50eaa1b2dc.jpg)
 
 The custom function passes the arguments `val` and `detail`, where `detail` is the new parameter in version 2.3.0, see the description below. The return type varies depending on the rule type.
 

docs/docs/en-US/guide/index.md

@@ -8,7 +8,7 @@ Please choose a different installation method depending on your browser:
 
 | | Browser | Lite Version | Full Version |
 | --- | --- | --- | --- |
-| ![Firefox Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_16x16.png) | Firefox | None | [Mozilla Add-on](https://addons.mozilla.org/en-US/firefox/addon/header-editor/) or our [self-distributed version](https://github.com/FirefoxBar/HeaderEditor/releases) |
+| ![Firefox Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/firefox/firefox_16x16.png) | Firefox | [Mozilla Add-ons](https://addons.mozilla.org/en-US/firefox/addon/header-editor-lite/) | [Mozilla Add-ons](https://addons.mozilla.org/en-US/firefox/addon/header-editor/) or our [self-distributed version](https://github.com/FirefoxBar/HeaderEditor/releases) |
 | ![Chrome Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/chrome/chrome_16x16.png) | Chrome | [Chrome Web Store](https://chrome.google.com/webstore/detail/header-editor/eningockdidmgiojffjmkdblpjocbhgh) | [Install full version](./install-full-version) |
 | ![Edge Logo](https://cdnjs.cloudflare.com/ajax/libs/browser-logos/75.0.1/edge/edge_16x16.png) | Edge | None | [Edge Addons](https://microsoftedge.microsoft.com/addons/detail/header-editor/afopnekiinpekooejpchnkgfffaeceko) |