Przejdź do głównej zawartości

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.
    • 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.
  • 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.

notatka

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

Obsługiwane typy: DNR

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ń

Obsługiwane typy: DNR

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.

warning

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

Obsługiwane platformy: macOS

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ś.
warning

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.

wskazówka

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

Obsługiwane typy: Oryginalny Obsługiwane platformy: macOS

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.

warning

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

Obsługiwane typy: Oryginalny

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 na https%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 na aGVsbG8=, i zdekodować z powrotem na hello.
  • 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 to l, a Zamiana to y, zostanie to zmodyfikowane na heyyo.
notatka

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
  • 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

Obsługiwane typy: Oryginalny

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 po https://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 parametru q.
  • 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.

notatka

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 po https://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 parametru q 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.