Lewati ke konten utama

Pengaturan Aturan

Halaman ini menyediakan informasi terperinci tentang setiap pengaturan di layar Edit Aturan di aplikasi Redirect Web.

Opsi​

Tipe​

Tentukan opsi Tipe untuk mengontrol bagaimana aplikasi menangani pengalihan. Anda dapat memilih dari ini:

  • Asli (Default)
    • Ini menggunakan API Web tradisional untuk mengontrol pengalihan. Selain itu, ini menggunakan Tabs API sebagai cadangan.
      • Di Firefox, ini menggunakan WebRequest API untuk menangani pengalihan.
    • Anda dapat menggunakan semua opsi selain Jenis Sumber Daya dan Metode Permintaan.
    • Ini lebih lambat dari tipe Deklaratif dan dapat menyebabkan permintaan jaringan tambahan.
  • DNR (Eksperimental untuk Safari):
    • Tipe ini bekerja jauh lebih cepat daripada tipe Asli karena tidak memulai permintaan jaringan untuk URL sumber.
    • Ini memungkinkan Anda untuk menentukan Jenis Sumber Daya dan Metode Permintaan.
    • ⚠️ Anda tidak dapat menggunakan beberapa opsi, seperti Pemrosesan Grup Penangkapan dan Pola URL yang Dikecualikan karena belum didukung oleh DNR API.
    • ⚠️ Di Safari, saat ini Anda tidak dapat menyertakan pipa (|) dalam pola Ekspresi Reguler Anda. Detail
    • ⚠️ Karena DNR API Safari masih memiliki beberapa masalah, kami menganggapnya masih merupakan fitur eksperimental untuk Safari. Anda dapat menemukan daftar semua masalah yang diketahui di sini.

Alihkan Dari​

Opsi Alihkan Dari memungkinkan Anda untuk menentukan pola URL halaman web yang ingin Anda alihkan. Anda dapat memilih Wildcard atau Ekspresi Reguler.

Misalnya, jika Anda menentukan https://example.com/* dengan Wildcard, itu cocok dengan https://example.com/ atau https://example.com/hello.

[!CATATAN] Dalam opsi Alihkan Ke, Anda dapat mereferensikan seluruh kecocokan menggunakan $0 atau kecocokan parsial menggunakan $1, $2, ... Periksa detailnya di Pola URL di halaman ini.

Jenis Sumber Daya​

Jenis yang Didukung: DNR

Opsi Jenis Sumber Daya memungkinkan Anda menentukan kategori permintaan web, seperti gambar, JavaScript, dan lembar gaya, tempat aturan berlaku. Misalnya, jika Anda mengatur script, Anda dapat mengalihkan file JavaScript yang dimuat oleh halaman web.

Saat ini, ini tersedia: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Pengaturan default adalah main_frame, yang merupakan halaman tingkat atas yang dimuat ke dalam tab.

Silakan periksa detail setiap jenis sumber daya di mdn web docs.

Metode Permintaan​

Jenis yang Didukung: DNR

Opsi Metode Permintaan memungkinkan Anda mengatur metode HTTP target dari URL sumber.

Semua metode diatur secara default.

Silakan periksa detail setiap metode di mdn web docs.

[!PERINGATAN] Di Safari, opsi ini mungkin tidak tersedia karena implementasi Apple untuk tipe DNR tampaknya tidak menanganinya saat ini. Kami mengirimkan umpan balik ke Apple sebagai FB14502272.

Browser Target​

Platform yang Didukung: macOS

Opsi Browser Target memungkinkan Anda menentukan browser mana yang harus atau tidak boleh diterapkan aturan.

  • Ada 2 jenis browser yang dapat Anda pilih:
    • Browser yang dapat Anda pilih secara default: Anda dapat memilih Safari, Chrome, Firefox, Edge, Opera, Arc, Brave, dan Vivaldi secara default. Ini tidak membedakan varian browser yang sama, seperti Safari dan Safari Technology Preview.
    • Browser yang ditentukan pengguna: Dengan mengetuk tombol Tambah pada popover, Anda dapat memilih browser apa pun selain Safari atau Safari Technology Preview yang telah menginstal ekstensi Redirect Web.
  • Kotak centang Semua kecuali yang dipilih memungkinkan Anda menargetkan setiap browser kecuali yang telah Anda pilih.

[!PERINGATAN] Redirect Web tidak dapat membedakan apakah browser tersebut adalah Safari atau Safari Technology Preview karena aplikasi memeriksa proses induk ekstensi untuk mendeteksinya tetapi kedua browser ini berbagi proses induk yang sama (/sbin/launchd).

Alihkan Ke​

Opsi Alihkan Ke menentukan URL tujuan yang ingin Anda alihkan, dari URL sumber yang cocok dengan opsi Alihkan Dari. Anda juga dapat mengganti grup penangkapan dengan $1, $2, ... atau seluruh kecocokan dengan $0. Ini membantu Anda menentukan tujuan secara dinamis. Periksa detailnya di Pola URL di halaman ini.

Misalnya, jika Anda mengatur aturan berikut:

  • Alihkan Dari: https://google.com/* (Wildcard)
  • Alihkan Ke: https://apple.com/$1

dan itu cocok dengan https://google.com/hello, maka URL tujuan akan menjadi https://apple.com/hello.

Selain itu, Anda dapat memodifikasi teks $1, $2, ... sebelum melakukan substitusi. Periksa bagian Pemrosesan Grup Penangkapan untuk detailnya.

tip

Anda dapat menentukan skema URL kustom untuk membuka aplikasi. Ini adalah contoh aplikasi yang mendukung deep linking:

  • 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

Aplikasi​

Jenis yang Didukung: Asli Platform yang Didukung: macOS

Jika Anda ingin menentukan aplikasi yang ingin Anda buka URL tujuannya, gunakan kotak kombo Aplikasi. Ini hanya tersedia di macOS.

[!PERINGATAN] Anda hanya dapat membuka aplikasi yang mendukung App Sandbox. Juga, pastikan aplikasi mendukung pembukaan URL yang ingin Anda buka.

Pemrosesan Grup Penangkapan​

Jenis yang Didukung: Asli

Opsi Pemrosesan Grup Penangkapan memungkinkan Anda menentukan cara memproses grup yang ditangkap yang dapat Anda substitusikan dalam opsi Alihkan Ke dengan $1, $2...

Ini adalah cara membuat grup penangkapan:

  • Wildcard: Teks yang cocok dengan * dan ? secara otomatis ditangkap.
  • Ekspresi Reguler: Teks yang cocok dengan bagian pola di dalam () ditangkap.

Anda dapat memilih satu atau lebih dari proses berikut:

  • URL Encode/Decode: Ini menerapkan percent-encoding atau decoding ke grup penangkapan. Misalnya, jika Anda mengkodekan https://example.com/hello, itu diubah menjadi https%3A%2F%2Fexample.com%2Fhello. Decode bekerja dengan cara yang berlawanan.
  • Base64 Encode/Decode: Ini mendekode/mengkodekan teks menjadi Base64. Misalnya, Anda dapat mengkodekan hello menjadi aGVsbG8=, dan mendekodekannya kembali menjadi hello.
  • Ganti Kejadian: Ini mengganti satu atau lebih karakter dalam grup, yang cocok dengan Target, dengan Pengganti. Misalnya, jika Grup adalah hello dan Target adalah l dan Pengganti adalah y, itu dimodifikasi menjadi heyyo.

[!CATATAN] Ini untuk memproses setiap grup penangkapan dan tidak memengaruhi URL mana yang dikecualikan oleh Pola URL yang Dikecualikan. Misalnya, katakanlah Anda memiliki aturan ini:

  • Alihkan Dari: https://example.com/(hello.*)
  • Pemrosesan Grup Penangkapan:
    • Grup: $1
    • Target: .* (Ekspresi Reguler)
    • Pengganti: hello
  • Pola URL yang Dikecualikan: https://example.com/hello

Dalam kasus ini, https://example.com/hello_world tidak akan dikecualikan sedangkan https://example.com/hello akan dikecualikan.

Pola URL yang Dikecualikan​

Jenis yang Didukung: Asli

Opsi Pola URL yang Dikecualikan memungkinkan Anda menentukan URL yang tidak dialihkan. Ini dapat berguna untuk menghindari loop pengalihan atau untuk mengecualikan bagian tertentu dari situs web agar tidak dialihkan.

Anda dapat menentukan pola URL yang dikecualikan menggunakan jenis pola Ekspresi Reguler atau Wildcard.

Contoh​

Opsi Contoh memungkinkan Anda menguji aturan pengalihan Anda dengan menyediakan contoh URL. Dengan menambahkan contoh URL, Anda dapat memeriksa apakah aturan berfungsi seperti yang diharapkan sebelum benar-benar menerapkannya.

Komentar​

Opsi Komentar memungkinkan Anda menambahkan catatan atau komentar tentang aturan pengalihan Anda. Ini dapat berguna untuk melacak mengapa Anda membuat aturan tertentu atau untuk memberikan konteks bagi orang lain yang mungkin melihat aturan Anda.

Anda dapat menulis komentar dalam format berikut:

  • Teks Biasa (Default): Teks sederhana tanpa format apa pun.
  • Markdown: Anda dapat menggunakan sintaks Markdown GitHub, termasuk beberapa ekstensi yang tidak didukung GFM. Misalnya, Anda dapat membuat judul, daftar, tautan, dan lainnya.
  • AsciiDoc: Anda dapat menggunakan sintaks AsciiDoc untuk memformat komentar Anda.

Pola URL​

Pola URL digunakan untuk mencocokkan URL dalam opsi Alihkan Dari, Pola URL yang Dikecualikan, dan Pemrosesan Grup Penangkapan. Untuk menentukannya, Anda dapat memilih Wildcard atau Ekspresi Reguler.

Wildcard​

Wildcard adalah jenis pola yang lebih sederhana yang memungkinkan Anda menggunakan * (cocok dengan apa saja) dan ? (cocok dengan karakter tunggal apa pun) sebagai wildcard. Berikut adalah beberapa contoh:

  • Untuk mencocokkan https://example.com/hello, Anda dapat menggunakan https://example.com/*. Ini akan cocok dengan string apa pun setelah https://example.com/.
  • Untuk mencocokkan https://example.com/search?q=hello, Anda dapat menggunakan https://example.com/search?q=*. Ini akan cocok dengan nilai apa pun untuk parameter q.
  • Untuk mencocokkan URL apa pun yang berisi kata blog, Anda dapat menggunakan *blog*.

Anda juga dapat menggunakan substitusi di Wildcard, yang berarti Anda dapat mereferensikan bagian dari URL yang cocok menggunakan $1, $2, dll. Misalnya, jika Anda menggunakan https://example.com/*-world-*, dan URL-nya adalah https://example.com/hello-world-goodbye, maka $1 akan menjadi "hello" dan $2 akan menjadi "goodbye". $0 juga tersedia untuk mereferensikan seluruh URL yang cocok.

[!CATATAN] Meskipun substitusi adalah fitur Ekspresi Reguler, Anda juga dapat menggunakannya untuk Wildcard karena Redirect Web secara internal mengubah Wildcard menjadi Ekspresi Reguler.

Ekspresi Reguler​

Ekspresi Reguler (Regex) adalah alat yang ampuh untuk mencocokkan pola dalam teks dan juga banyak digunakan dalam pemrograman. Ini memungkinkan Anda untuk menentukan pola tertentu yang cocok dengan sekumpulan string. Berikut adalah beberapa contoh.

  • Untuk mencocokkan https://example.com/hello, Anda dapat menggunakan https://example.com/.*. Ini akan cocok dengan string apa pun setelah https://example.com/.
  • Untuk mencocokkan https://example.com/search?q=hello, Anda dapat menggunakan https://example.com/search\?q=(.*). Ini akan cocok dengan nilai parameter q dan menyimpannya dalam grup penangkapan. Anda kemudian dapat mereferensikannya menggunakan $1 dalam opsi Alihkan Ke.
  • Untuk mencocokkan URL apa pun yang berisi kata blog, Anda dapat menggunakan .*blog.*.

Anda dapat mereferensikan grup penangkapan di Alihkan Ke atau Pengganti menggunakan $1, $2, ... atau $0 untuk mereferensikan seluruh kecocokan.

Redirect Web didukung oleh mesin Regex Apple.

Informasi lebih lanjut tentang sintaks Regex dapat ditemukan di sumber daya seperti RegExr.