Recursos avançados
Regras
Você pode editar as regras para bloquear sites na página de opções, ou também no diálogo de "Bloquear este site".
Você pode escrever regras usando match patterns ou expressões.
Match patterns
Match patterns são URLs que incluem curingas. Você pode encontrar mais detalhes nas MDN web docs.
Aqui estão alguns exemplos de match patterns válidos:
| Padrão | Exemplos de correspondência |
|---|---|
*://example.com/*(URLs hospedadas em example.com) | http://example.com/https://example.com/hoge |
*://*.example.net/*(URLs hospedadas em example.net ou seus subdomínios) | http://example.net/https://foo.example.net/hoge |
*://example.org/hoge/*(URLs hospedadas em example.org com caminhos começando em /hoge/) | http://example.org/hoge/fuga.html |
Aqui estão alguns exemplos de match patterns inválidos:
| Padrão inválido | Motivo |
|---|---|
*://www.qinterest.*/ | * não está no começo. |
Expressões
Você pode escrever regras com expressões.
Variáveis
No momento, url e title estão disponíveis nas expressões.
# Resultados de busca que incluem "example"
url *= "example"
# Resultados de busca quais o título começa com "Something"
title ^= "Something"
Partes de uma URL também estão disponíveis: scheme, host, e path.
# Resultados de busca quais o esquema é HTTP
scheme="http"
# Resultados de busca quais os servidores terminam com ".example.com"
host $= ".example.com"
# Resultados de busca quais o caminho incluem "blah", sem importar os maiúsculos
path*="blah"i
Além disso, propriedades das páginas dos resultados do motor de busca estão disponíveis. No momento, estão disponíveis $site e $category.
# Bloquear o YouTube na busca do Google
$site="google" & host="youtube.com"
# Bloquear a Amazon na busca de imagens
$category = "images" & host = "www.amazon.com"
Correspondentes de strings
Os correspondentes de string se assemelham a seletores de atributos de CSS.
# Títulos que são exatamente "Example Domain"
title = "Example Domain"
# Títulos que começam com "Example"
title ^= "Example"
# Títulos que terminam com "Domain"
title $= "Domain"
# Títulos que incluem "ple Dom"
title *= "ple Dom"
Para realizar comparações sem importância dos maiúsculos, use o operador i.
# Títulos que terminam com "domain", sem se importar por maiúsculos
title $= "domain" i
Expressões regulares
Você pode escrever expressões mais flexíveis usando as expressões regulares.
# URLs que incluem "example.net" ou "example.org"
url =~ /example\.(net|org)/
# "=~" pode ser omitido
url/example\.(net|org)/
# "url" pode ser omitido
/example\.(net|org)/
# Títulos que incluem "example domain", sem se importar pelos maiúsculos
title =~ /example domain/i
Observe que as expressões regulares devem ser literais se expressão regular em JavaScript, envolvidos com / (ex: /example\.(net|org)/).
Aqui estão alguns exemplos de expressões regulares válidas:
| Expressão regular | Exemplos de correspondência |
|---|---|
/^https:\/\/www\.qinterest\./(URLs que começam com https://www.qinterest.) | https://www.qinterest.com/https://www.qinterest.jp/hoge |
/^https?:\/\/([^/.]+\.)*?xn--/(URLs incluindo nomes internacionalizados de domínios) | http://例.テスト/ |
Aqui estão alguns exemplos de expressões regulares inválidas:
| Expressões regulares inválidas | Motivo |
|---|---|
^https?:\/\/example\.com\/ | Não cercado por /. |
/^https?://example\.com// | / interior não foi desprendido. |
Operadores lógicos
"Não" (!), "e" (&), e "ou" (£) lógicos são suportados.
# Bloquear esquemas diferentes de HTTPS
!scheme="https"
# Bloquear Amazon em busca de imagens
$category = "images" & host = "www.amazon.com"
# Títulos incluindo "example" ou "domain", sem se importar por maiúsculos
title *= "example" i | title *= "domain" i
Use expressões com match patterns
Você pode adicionar @if(expression) aos match patterns.
# Bloquear Amazon na busca de imagens
*://*.amazon.com/* @if($category="images")
Regras de desbloqueio
Match patterns ou expressões regulares prefixados por @ significam que os sites especificados não são bloqueados.
Elas podem ser usadas para desbloquear sites bloqueados por inscrições. Por exemplo, se http://example.com/ é bloqueado por uma inscrição, você pode desbloqueá-lo usando @*://example.com/*.
Regras de destaque
Match patterns ou expressões regulares prefixados com @N (N=1,2,3,...) significam que os sites específicos são destacados.
Por exemplo, você pode destacar example.com usando @1*://example.com/*`.
Por padrão, somente @1 (azul) está disponível. Para alterar ou adicionar cores de destaque, veja a seção de "Aparência" na página de opções.
Comentários
Comentários começam com #. Mesmo que qualquer linha que não pode ser interpretada como uma regra é efetivamente um comentário, um comentário com # é melhor em duas formas:
- Comentários com
#são garantidos como comentários, mesmo se sintaxes novas forem introduzidas no futuro. - Comentários com
#podem ser colocados após regras.
# Bloquear páginas quais URLs são hospedadas em example.com ou seus subdomínios
*://*.example.com/*
/example\.(net|org)/ #Bloquear páginas quais URLs contêm example.net ou example.org
Outros mecanismos de busca
Essa extensão suporta o Bing, Brave, DuckDuckGo, Ecosia, SearXNG, Startpage.com, Yahoo! JAPAN, e o Yandex. Esse recurso está desativado por padrão e pode ser ativado na página de opções.
Sincronização
Você pode sincronizar conjuntos de regras entre dispositivos usando o Google Drive ou o Dropbox.
Para ativar a sincronização, clique no botão "Ativar sincronização" na página de opções e selecione uma nuvem.
Siga as instruções no diálogo para autenticar-se.
Assim que a autenticação ser feita, seu conjunto de regras será sincronizado rregularmente com a nuvem selecionada.
Google Drive
Se você usa o Firefox ou um de seus derivados, será necessário dar acesso a https://www.googleapis.com.
O conjunto de regras é salvo na pasta de dados do aplicativo no seu Google Drive. É oculto de você, mas você pode apagá-lo na página de configurações do Google Drive.
Dropbox
O conjunto de regras é salvo em /Apps/uBlacklist/ em sua Dropbox. O nome da pasta pode variar dependendo do seu idioma.
Inscrição
Você pode inscrever-se a conjuntos de regras públicos. Uma lista de inscrições públicas conhecidas podem ser encontradas na página Inscrições.
Para adicionar uma inscrição, clique no botão "Adicionar inscrição" e digite o nome e a URL. Será necessário dar acesso à origem da URL.
Você pode ver, atualizar, ou remover uma inscrição.
Publicar uma inscrição
Para publicar um conjunto de regras como uma inscrição, coloque um arquivo de conjunto de regras codificado em UTF-8 em um servidor de HTTP(S) adequado, e publique a URL.
Você pode prefixar o YAML frontmatter ao seu conjunto de regras. É recomendado configurar a variável name.
---
name: Nome do seu conjunto
---
*://*.example.com/*
É uma boa ideia hospedar sua inscrição no GitHub. Certifique-se de publicar a URL bruta (ex: https://raw.githubusercontent.com/iorate/ublacklist-example-subscription/master/uBlacklist.txt).
Links de inscrição
Esse recurso está disponível na v8.11.0 e posterior. Os usuários precisam ativar este recurso de forma explícita, ativando "Ativar links de inscrição em conjunto de regras" na página de opções da extensão.
Este recurso não funciona no Safari no momento.
Para compartilhamento mais fácil da sua inscrição, você pode criar um link de inscrição no seguinte formato:
https://ublacklist.github.io/rulesets/subscribe?url=<url-encoded-url>
Onde <url-encoded-url> é a URL do seu conjunto de regras após codificá-la. Quando usuários clicam neste link, serão direcionados à página de opções da extensão com a sua inscrição pré-preenchida, facilitando que eles se inscrevam.
Por exemplo, se seu conjunto de regras é hospedado em:
https://raw.githubusercontent.com/username/repository/master/ublacklist.txt
Seu link de inscrição seria:
https://ublacklist.github.io/rulesets/subscribe?url=https%3A%2F%2Fraw.githubusercontent.com%2Fusername%2Frepository%2Fmaster%2Fublacklist.txt