Remove URL trackers

Removes annoying url trackers parameters like utm_*, ref, etc, directly from the address bar.

您需要先安裝使用者腳本管理器擴展,如 TampermonkeyGreasemonkeyViolentmonkey 之後才能安裝該腳本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyViolentmonkey 後才能安裝該腳本。

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyUserscripts 後才能安裝該腳本。

你需要先安裝一款使用者腳本管理器擴展,比如 Tampermonkey,才能安裝此腳本

您需要先安裝使用者腳本管理器擴充功能後才能安裝該腳本。

(我已經安裝了使用者腳本管理器,讓我安裝!)

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

(我已經安裝了使用者樣式管理器,讓我安裝!)

// ==UserScript==
// @name         Remove URL trackers
// @namespace    https://github.com/insign/userscripts
// @version      202409181423
// @description  Removes annoying url trackers parameters like utm_*, ref, etc, directly from the address bar.
// @match        *://*/*
// @author       Hélio <[email protected]>
// @license      WTFPL
// ==/UserScript==

(function() {
	'use strict'
	// Parâmetros (que começam com esses prefixos) a serem removidos da URL.
	const paramsToStrip = ['utm_', 'ref', 'gclid', 'gclsrc', 'gs_', 'ga_', '_ga', '_gaq', '__utm', 'fbclid', 'mc_', '_cid', 'epik', 'context']

	/**
	 * Verifica se um parâmetro deve ser removido da URL.
	 * @param {string} param - O nome do parâmetro (formato chave=valor).
	 * @returns {boolean} - True se o parâmetro deve ser preservado, false caso contrário.
	 */
	function shouldPreserveParam(param) {
		// Retorna true se NENHUM prefixo da lista paramsToStrip for encontrado no início do parâmetro.
		return !paramsToStrip.some(prefix => param.startsWith(prefix))
	}

	/**
	 * Limpa a URL removendo os parâmetros especificados.
	 * @param {string} url - A URL original.
	 * @returns {string} - A URL limpa com os parâmetros indesejados removidos.
	 */
	function cleanUrl(url) {
		// Usa replace com regex para encontrar a parte da query string (?...)
		// A função de callback processa os parâmetros encontrados.
		return url.replace(/\?([^#]*)/, (match, searchParams) => {
			// Divide os parâmetros (&), filtra mantendo apenas os que devem ser preservados,
			// e junta novamente com &.
			const updatedParams = searchParams
					.split('&')
					.filter(shouldPreserveParam) // Mantém apenas os parâmetros não correspondentes.
					.join('&')

			// Retorna a query string atualizada (se houver parâmetros restantes) ou uma string vazia
			// para remover completamente a interrogação se todos os parâmetros foram removidos.
			return updatedParams ? '?' + updatedParams : ''
		})
	}

	/**
	 * Atualiza a URL do navegador substituindo o estado do histórico, se necessário.
	 * Isso evita que a URL original com rastreadores permaneça no histórico de navegação.
	 */
	function updateUrl() {
		const currentUrl = location.href // URL atual
		const cleanedUrl = cleanUrl(currentUrl) // URL após limpeza

		// Se a URL foi modificada e a API history.replaceState está disponível,
		// substitui a entrada atual no histórico pela URL limpa.
		if (currentUrl !== cleanedUrl && window.history.replaceState) {
			window.history.replaceState({}, '', cleanedUrl)
			console.log('URL Trackers Removed:', currentUrl, '->', cleanedUrl)
		}
	}

	// Executa a limpeza apenas se a URL contiver parâmetros de busca (presença de ? ou &).
	// Isso evita processamento desnecessário em URLs sem parâmetros.
	if (location.search && /[\?&]/.test(location.search)) {
		updateUrl()
	}
})()