Ustawienia reguł
Ta strona zawiera szczegółowe informacje o każdym ustawieniu na ekranie Edytuj regułę w aplikacji Redirect Web.
Opcje
Typ
Określ opcję Typ, aby kontrolować, w jaki sposób aplikacja obsługuje przekierowanie. Możesz wybrać spośród następujących:
- Oryginalny (domyślny)
- Wykorzystuje tradycyjne interfejsy API sieci Web do kontrolowania przekierowania. Dodatkowo, używa interfejsu API kart jako rozwiązania awaryjnego.
- W Firefoksie używa interfejsu API WebRequest do obsługi przekierowania.
- Możesz użyć wszystkich opcji innych niż Typy zasobów i Metody żądań.
- Jest to wolniejsze niż typ Deklaratywny i może powodować dodatkowe żądania sieciowe.
- Wykorzystuje tradycyjne interfejsy API sieci Web do kontrolowania przekierowania. Dodatkowo, używa interfejsu API kart jako rozwiązania awaryjnego.
- DNR (eksperymentalne dla Safari):
- Ten typ działa znacznie szybciej niż typ oryginalny, ponieważ nie inicjuje żądania sieciowego dla źródłowego adresu URL.
- Pozwala to określić Typy zasobów i Metody żądań.
- ⚠️ Niektóre opcje, takie jak Przetwarzanie grup przechwytujących i Wykluczone wzorce adresów URL, nie są obsługiwane, ponieważ nie zostały jeszcze zaimplementowane w interfejsie API DNR.
- ⚠️ W Safari, obecnie nie możesz używać pionowych kresek (
|
) w swoim wzorcu wyrażenia regularnego. Szczegóły - ⚠️ Ponieważ interfejs API DNR w Safari nadal ma pewne problemy, uważamy, że jest to nadal funkcja eksperymentalna dla Safari. Listę wszystkich znanych problemów znajdziesz tutaj.
Przekieruj z
Opcja Przekieruj z pozwala określić wzorzec adresu URL stron internetowych, z których chcesz przekierować. Możesz wybrać Wildcard lub Wyrażenie regularne.
Na przykład, jeśli określisz https://example.com/*
z Wildcard, pasuje to do https://example.com/
lub https://example.com/hello
.
W opcji Przekieruj do, możesz odwołać się do całego dopasowania za pomocą $0
lub częściowych dopasowań za pomocą $1
, $2
, ... Sprawdź szczegóły w Wzorzec adresu URL na tej stronie.
Typy zasobów
Opcja Typy zasobów pozwala określić kategorie żądań sieciowych, takie jak obrazy, skrypty JavaScript i arkusze stylów, do których ma zastosowanie reguła.
Na przykład, jeśli ustawisz script
, możesz przekierować pliki JavaScript ładowane przez strony internetowe.
Obecnie dostępne są:
main_frame
, sub_frame
, stylesheet
, script
, image
, font
, xmlhttprequest
, ping
, media
, websocket
, other
Domyślne ustawienie to main_frame
, czyli strona najwyższego poziomu ładowana do karty.
Sprawdź szczegóły każdego typu zasobu w mdn web docs.
Metody żądań
Opcja Metody żądań pozwala ustawić docelowe metody HTTP źródłowego adresu URL.
Wszystkie metody są ustawione domyślnie.
Sprawdź szczegóły każdej metody w mdn web docs.
W Safari ta opcja może nie być dostępna, ponieważ implementacja Apple dla typu DNR wydaje się jej obecnie nie obsługiwać. Wysyłaliśmy opinię do Apple jako FB14502272.
Przeglądarki docelowe
Opcja Przeglądarki docelowe pozwala określić, do której przeglądarki reguła powinna lub nie powinna być stosowana.
- Istnieją 2 typy przeglądarek, które możesz wybrać:
- Przeglądarki, które możesz wybrać domyślnie: Domyślnie możesz wybrać Safari, Chrome, Firefox, Edge, Opera, Arc, Brave i Vivaldi. Nie rozróżnia to wariantów tej samej przeglądarki, takich jak Safari i Safari Technology Preview.
- Przeglądarki określone przez użytkownika: Dotykając przycisku Dodaj w wyskakującym okienku, możesz wybrać dowolną przeglądarkę inną niż Safari lub Safari Technology Preview, która ma zainstalowane rozszerzenie Redirect Web.
- Pole wyboru Wszystkie oprócz wybranych pozwala na celowanie we wszystkie przeglądarki z wyjątkiem tych, które wybrałeś.
Redirect Web nie potrafi rozróżnić, czy przeglądarka to Safari czy Safari Technology Preview, ponieważ aplikacja sprawdza proces nadrzędny rozszerzenia, aby to wykryć, ale te dwie przeglądarki współdzielą ten sam proces nadrzędny (/sbin/launchd
).
Przekieruj do
Opcja Przekieruj do określa docelowy adres URL, na który chcesz przekierować, ze źródłowego adresu URL dopasowanego do opcji Przekieruj z. Możesz również podstawić grupy przechwytujące za pomocą $1
, $2
, ... lub całe dopasowanie za pomocą $0
. Pomaga to dynamicznie określić miejsce docelowe. Sprawdź szczegóły w Wzorzec adresu URL na tej stronie.
Na przykład, jeśli ustawisz następującą regułę:
- Przekieruj z:
https://google.com/*
(Wildcard) - Przekieruj do:
https://apple.com/$1
i pasuje do https://google.com/hello
, to docelowy adres URL będzie https://apple.com/hello
.
Dodatkowo, możesz modyfikować teksty $1
, $2
, ... przed dokonaniem podstawień. Sprawdź sekcję Przetwarzanie grup przechwytujących, aby uzyskać szczegóły.
Możesz określić niestandardowy schemat URL, aby otworzyć aplikację. Oto przykłady aplikacji, które obsługują głębokie linkowanie:
- Figma:
figma://file/Your_Figma_ID
- Firefox:
firefox://open-url?url=https://example.com/hello
- Google Chrome:
googlechromes://example.com
- Microsoft Edge:
microsoft-edge://example.com
- Notion:
notion://www.notion.so/Your_Note_ID
- Slack:
slack://open
Aplikacja
Jeśli chcesz określić aplikację, w której chcesz otworzyć docelowy adres URL, użyj pola kombi Aplikacja. Jest to dostępne tylko w systemie macOS.
Możesz otworzyć tylko aplikację, która obsługuje App Sandbox. Upewnij się również, że aplikacja obsługuje otwieranie adresu URL, który chcesz otworzyć.
Przetwarzanie grup przechwytujących
Opcja Przetwarzanie grup przechwytujących pozwala określić, jak przetwarzać przechwycone grupy, które można podstawić w opcji Przekieruj do za pomocą $1
, $2
...
Oto jak tworzyć grupy przechwytujące:
- Wildcard: Teksty dopasowane do
*
i?
są automatycznie przechwytywane. - Wyrażenie regularne: Teksty dopasowane do części wzorca wewnątrz
()
są przechwytywane.
Możesz wybrać jeden lub więcej z następujących procesów:
- Kodowanie/dekodowanie URL: Stosuje kodowanie procentowe lub dekodowanie do grupy przechwytującej. Na przykład, jeśli zakodujesz
https://example.com/hello
, zostanie to przekonwertowane nahttps%3A%2F%2Fexample.com%2Fhello
. Dekodowanie działa w odwrotny sposób. - Kodowanie/dekodowanie Base64: Dekoduje/koduje tekst do Base64. Na przykład, możesz zakodować
hello
naaGVsbG8=
, i zdekodować z powrotem nahello
. - Zastąp wystąpienia: Zastępuje jeden lub więcej znaków w grupie, dopasowanych przez Cel, za pomocą Zamiany. Na przykład, jeśli Grupa to
hello
, a Cel tol
, a Zamiana toy
, zostanie to zmodyfikowane naheyyo
.
Służy to do przetwarzania każdej grupy przechwytującej i nie wpływa na to, które adresy URL są wykluczone przez Wykluczone wzorce adresów URL. Na przykład, załóżmy, że masz taką regułę:
- Przekieruj z:
https://example.com/(hello.*)
- Przetwarzanie grup przechwytujących:
- Grupa:
$1
- Cel:
.*
(Wyrażenie regularne) - Zamiana:
hello
- Grupa:
- Wykluczony wzorzec adresu URL:
https://example.com/hello
W tym przypadku https://example.com/hello_world
nie zostanie wykluczone, podczas gdy https://example.com/hello
zostanie wykluczone.
Wykluczone wzorce adresów URL
Opcja Wykluczone wzorce adresów URL pozwala określić adresy URL, które nie są przekierowywane. Może to być przydatne, aby uniknąć pętli przekierowań lub wykluczyć niektóre części witryny z przekierowania.
Możesz określić wykluczone wzorce adresów URL, używając typów wzorców Wyrażenie regularne lub Wildcard.
Przykłady
Opcja Przykłady pozwala przetestować regułę przekierowania, podając przykładowe adresy URL. Dodając przykładowy adres URL, możesz sprawdzić, czy reguła działa zgodnie z oczekiwaniami, zanim faktycznie ją zastosujesz.
Komentarze
Opcja Komentarze pozwala dodawać wszelkie notatki lub komentarze dotyczące reguły przekierowania. Może to być przydatne do śledzenia, dlaczego utworzyłeś określoną regułę lub do dostarczenia kontekstu dla innych, którzy mogą przeglądać Twoje reguły.
Wzorzec adresu URL
Istnieją 3 opcje, w których można określić jeden lub więcej wzorców adresów URL. Przekieruj z, Wykluczone wzorce adresów URL i Przetwarzanie grup przechwytujących. Aby je określić, możesz wybrać Wildcard lub Wyrażenie regularne.
Wildcard
Wildcard to prostszy typ wzorca, który pozwala używać *
(pasuje do wszystkiego) i ?
(pasuje do dowolnego pojedynczego znaku) jako symboli wieloznacznych. Oto kilka przykładów:
- Aby dopasować
https://example.com/hello
, możesz użyćhttps://example.com/*
. Spowoduje to dopasowanie dowolnego ciągu pohttps://example.com/
. - Aby dopasować
https://example.com/search?q=hello
, możesz użyćhttps://example.com/search?q=*
. Spowoduje to dopasowanie dowolnej wartości dla parametruq
. - Aby dopasować dowolny adres URL zawierający słowo
blog
, możesz użyć*blog*
.
Możesz również użyć podstawienia w Wildcard, co oznacza, że możesz odwoływać się do części dopasowanego adresu URL za pomocą $1
, $2
itd. Na przykład, jeśli użyjesz https://example.com/*-world-*
, a adres URL to https://example.com/hello-world-goodbye
, to $1
będzie „hello”, a $2
będzie „goodbye”. $0
jest również dostępne do odwoływania się do całego dopasowanego adresu URL.
Chociaż podstawienie jest cechą wyrażeń regularnych, możesz go również użyć dla Wildcard, ponieważ Redirect Web wewnętrznie konwertuje Wildcard na wyrażenie regularne.
Wyrażenie regularne
Wyrażenie regularne (Regex) to potężne narzędzie do dopasowywania wzorców w tekście, oparte na silniku wyrażeń regularnych Apple, który jest opisany tutaj. Pozwala zdefiniować konkretny wzorzec, który pasuje do zestawu ciągów. Oto kilka przykładów.
- Aby dopasować
https://example.com/hello
, możesz użyćhttps://example.com/(.*)
. Spowoduje to dopasowanie dowolnego ciągu pohttps://example.com/
i zapisanie go w grupie przechwytującej. - Aby dopasować
https://example.com/search?q=hello
, możesz użyćhttps://example.com/search\?q=(.*)
. Spowoduje to dopasowanie wartości parametruq
i zapisanie jej w grupie przechwytującej. - Aby dopasować dowolny adres URL zawierający słowo
blog
, możesz użyć.*blog.*
.
Możesz odwoływać się do grup przechwytujących w Przekieruj do lub Zamiana za pomocą $1
, $2
, ... lub $0
do odwołania się do całego dopasowania.
Więcej informacji na temat składni Regex można znaleźć w zasobach takich jak RegExr.