Remove URL trackers

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

За да инсталирате този скрипт, трябва да имате инсталирано разширение като Tampermonkey, Greasemonkey или Violentmonkey.

За да инсталирате този скрипт, трябва да имате инсталирано разширение като Tampermonkey или Violentmonkey.

За да инсталирате този скрипт, трябва да имате инсталирано разширение като Tampermonkey или Violentmonkey.

За да инсталирате този скрипт, трябва да имате инсталирано разширение като Tampermonkey или Userscripts.

За да инсталирате скрипта, трябва да инсталирате разширение като 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()
	}
})()