Chrome UTM Stripper 项目使用教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00043/article/details/139488055

Chrome UTM Stripper 项目使用教程

chrome-utm-stripper Browser extension that strips Google Analytics (UTM) parameters, and various other click tracking tokens, from URL query strings 项目地址: https://gitcode.com/gh_mirrors/ch/chrome-utm-stripper

1. 项目的目录结构及介绍

chrome-utm-stripper/
├── .github/
│   └── workflows/
│       └── store.yml
├── .eslintrc
├── .gitignore
├── LICENSE
├── Makefile
├── README.md
├── background.js
├── icon-128.png
├── icon-48.png
├── manifest.json
└── ...

目录结构介绍

.github/workflows/: 包含GitHub Actions的工作流配置文件，用于自动化部署和测试。
.eslintrc: ESLint配置文件，用于代码风格检查。
.gitignore: Git忽略文件配置，指定哪些文件或目录不需要被Git跟踪。
LICENSE: 项目的开源许可证文件，本项目使用MIT许可证。
Makefile: 用于自动化构建和测试的Makefile文件。
README.md: 项目的说明文档，包含项目的基本信息和使用指南。
background.js: 浏览器扩展的后台脚本文件，负责处理URL参数的剥离。
icon-128.png 和 icon-48.png: 浏览器扩展的图标文件，分别用于不同分辨率的显示。
manifest.json: 浏览器扩展的配置文件，定义了扩展的基本信息、权限和启动文件。

2. 项目的启动文件介绍

`background.js`

background.js 是Chrome UTM Stripper浏览器扩展的后台脚本文件。它负责在浏览器请求网页之前，剥离URL中的Google Analytics (UTM)参数和其他点击跟踪令牌。

// background.js 文件示例
chrome.webRequest.onBeforeRequest.addListener(
    function(details) {
        // 剥离URL参数的逻辑
        return {redirectUrl: stripUrl(details.url)};
    },
    {urls: ["<all_urls>"]},
    ["blocking"]
);

功能介绍

chrome.webRequest.onBeforeRequest.addListener: 监听浏览器请求事件，在请求发出之前执行回调函数。
stripUrl(details.url): 自定义函数，用于剥离URL中的跟踪参数。
{urls: ["<all_urls>"]}: 指定监听所有URL的请求。
["blocking"]: 以阻塞方式处理请求，确保在请求发出之前完成参数剥离。

3. 项目的配置文件介绍

`manifest.json`

manifest.json 是Chrome扩展的配置文件，定义了扩展的基本信息、权限和启动文件。

{
  "manifest_version": 2,
  "name": "Tracking Token Stripper",
  "version": "2.1.0",
  "description": "Strips Google Analytics (UTM) parameters and various other tracking tokens from URL query strings.",
  "background": {
    "scripts": ["background.js"]
  },
  "permissions": [
    "webRequest",
    "webRequestBlocking",
    "http://*/*",
    "https://*/*"
  ],
  "icons": {
    "48": "icon-48.png",
    "128": "icon-128.png"
  }
}

配置项介绍

manifest_version: 指定Manifest文件的版本，当前为版本2。
name: 扩展的名称，即“Tracking Token Stripper”。
version: 扩展的版本号，当前为2.1.0。
description: 扩展的描述信息，说明其功能是剥离URL中的跟踪参数。
background: 定义后台脚本文件，即background.js。
permissions: 扩展所需的权限，包括webRequest、webRequestBlocking以及所有HTTP和HTTPS请求的权限。
icons: 定义扩展的图标，分别用于48x48和128x128分辨率。