Ana içeriğe geç

Kural Ayarları

Bu sayfa, Redirect Web uygulamasındaki Kuralı Düzenle ekranındaki her ayar hakkında ayrıntılı bilgi sağlar.

Seçenekler

Tür

Uygulamanın yeniden yönlendirmeyi nasıl ele alacağını kontrol etmek için Tür seçeneğini belirtin. Bunlardan seçim yapabilirsiniz:

  • Orijinal (Varsayılan)
    • Bu, yeniden yönlendirmeyi kontrol etmek için geleneksel Web API'lerini kullanır. Ayrıca, bir yedek olarak Tabs API kullanır.
      • Firefox'ta, yeniden yönlendirmeyi ele almak için WebRequest API kullanır.
    • Kaynak Türleri ve İstek Yöntemleri dışındaki tüm seçenekleri kullanabilirsiniz.
    • Bu, Bildirimsel türden daha yavaştır ve ek ağ isteklerine neden olabilir.
  • DNR (Safari için Deneysel):
    • Bu tür, kaynak URL için bir ağ isteği başlatmadığı için Orijinal türden çok daha hızlı çalışır.
    • Bu, Kaynak Türleri ve İstek Yöntemleri belirtmenize olanak tanır.
    • ⚠️ Yakalanan Grup İşleme ve Hariç Tutulan URL Desenleri gibi bazı seçenekleri, henüz DNR API tarafından desteklenmediği için kullanamazsınız.
    • ⚠️ Safari'de, şu anda Düzenli İfade deseninize dikey çizgi (|) ekleyemezsiniz. Ayrıntılar
    • ⚠️ Safari'nin DNR API'si hala bazı sorunlara sahip olduğundan, Safari için hala deneysel bir özellik olduğunu düşünüyoruz. Bilinen tüm sorunların listesini burada bulabilirsiniz.

Şuradan Yönlendir

Şuradan Yönlendir seçeneği, yeniden yönlendirmek istediğiniz web sayfalarının bir URL desenini belirtmenize olanak tanır. Joker Karakter veya Düzenli İfade arasından seçim yapabilirsiniz.

Örneğin, Joker Karakter ile https://example.com/* belirtirseniz, bu https://example.com/ veya https://example.com/hello ile eşleşir.

not

Şuraya Yönlendir seçeneğinde, eşleşmenin tamamını $0 kullanarak veya kısmi eşleşmeleri $1, $2, ... kullanarak referans alabilirsiniz. Ayrıntılar için bu sayfadaki URL Deseni bölümünü kontrol edin.

Kaynak Türleri

Desteklenen Türler: DNR

Kaynak Türleri seçeneği, kuralın uygulanacağı resimler, JavaScript'ler ve stil sayfaları gibi web isteklerinin kategorilerini belirtmenize olanak tanır. Örneğin, script olarak ayarlarsanız, web sayfaları tarafından yüklenen JavaScript dosyalarını yeniden yönlendirebilirsiniz.

Şu anda şunlar mevcuttur: main_frame, sub_frame, stylesheet, script, image, font, xmlhttprequest, ping, media, websocket, other

Varsayılan ayar, bir sekmeye yüklenen en üst düzey sayfa olan main_frame'dir.

Her kaynak türünün ayrıntılarını mdn web docs adresinden kontrol edebilirsiniz.

İstek Yöntemleri

Desteklenen Türler: DNR

İstek Yöntemleri seçeneği, kaynak URL'nin hedef HTTP yöntemlerini ayarlamanıza olanak tanır.

Tüm yöntemler varsayılan olarak ayarlanmıştır.

Her yöntemin ayrıntılarını mdn web docs adresinden kontrol edebilirsiniz.

uyarı

Safari'de, bu seçenek kullanılamayabilir çünkü Apple'ın DNR türü için uygulaması şu anda bunu ele almıyor gibi görünüyor. Apple'a FB14502272 olarak geri bildirim gönderdik.

Hedef Tarayıcılar

Desteklenen Platformlar: macOS

Hedef Tarayıcılar seçeneği, kuralın hangi tarayıcıya uygulanması veya uygulanmaması gerektiğini belirtmenize olanak tanır.

  • Seçebileceğiniz 2 tür tarayıcı vardır:
    • Varsayılan olarak seçebileceğiniz tarayıcılar: Varsayılan olarak Safari, Chrome, Firefox, Edge, Opera, Arc, Brave ve Vivaldi'yi seçebilirsiniz. Bu, Safari ve Safari Technology Preview gibi aynı tarayıcının varyantlarını ayırt etmez.
    • Kullanıcı tanımlı tarayıcılar: Açılır pencerede Ekle düğmesine dokunarak, Safari veya Safari Technology Preview dışındaki, Redirect Web uzantısı yüklü olan herhangi bir tarayıcıyı seçebilirsiniz.
  • Seçilenler hariç tümü onay kutusu, seçtiğiniz tarayıcılar dışındaki her tarayıcıyı hedeflemenizi sağlar.
uyarı

Redirect Web, tarayıcının Safari mi yoksa Safari Technology Preview mu olduğunu ayırt edemez çünkü uygulama bunu tespit etmek için uzantının ana sürecini kontrol eder ancak bu iki tarayıcı aynı ana süreci (/sbin/launchd) paylaşır.

Şuraya Yönlendir

Şuraya Yönlendir seçeneği, Şuradan Yönlendir seçeneğiyle eşleşen kaynak URL'den yeniden yönlendirmek istediğiniz hedef URL'yi belirtir. Ayrıca, yakalanan grupları $1, $2, ... ile veya eşleşmenin tamamını $0 ile değiştirebilirsiniz. Bunlar, hedefi dinamik olarak belirtmenize yardımcı olur. Ayrıntılar için bu sayfadaki URL Deseni bölümünü kontrol edin.

Örneğin, aşağıdaki kuralı ayarlarsanız:

  • Şuradan Yönlendir: https://google.com/* (Joker Karakter)
  • Şuraya Yönlendir: https://apple.com/$1

ve bu https://google.com/hello ile eşleşirse, hedef URL https://apple.com/hello olacaktır.

Ek olarak, $1, $2, ... metinlerini değiştirmeden önce değiştirebilirsiniz. Ayrıntılar için Yakalanan Grup İşleme bölümünü kontrol edin.

ipucu

Bir uygulamayı açmak için özel bir URL şeması belirtebilirsiniz. Bunlar derin bağlantıyı destekleyen uygulamalara örnektir:

  • 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

Uygulama

Desteklenen Türler: Orijinal Desteklenen Platformlar: macOS

Hedef URL'yi açmak istediğiniz bir uygulamayı belirtmek isterseniz, Uygulama birleşik giriş kutusunu kullanın. Bu yalnızca macOS'ta kullanılabilir.

uyarı

Yalnızca App Sandbox uygulamasını destekleyen bir uygulamayı açabilirsiniz. Ayrıca, uygulamanın açmak istediğiniz URL'yi açmayı desteklediğinden emin olun.

Yakalanan Grup İşleme

Desteklenen Türler: Orijinal

Yakalanan Grup İşleme seçeneği, Şuraya Yönlendir seçeneğinde $1, $2... ile değiştirebileceğiniz yakalanan grupların nasıl işleneceğini belirtmenize olanak tanır.

Yakalanan gruplar şu şekilde oluşturulur:

  • Joker Karakter: * ve ? ile eşleşen metinler otomatik olarak yakalanır.
  • Düzenli İfade: () içindeki desenin bir kısmıyla eşleşen metinler yakalanır.

Aşağıdaki işlemlerden bir veya daha fazlasını seçebilirsiniz:

  • URL Kodla/Çöz: Bu, bir yakalama grubuna yüzde kodlaması uygular veya kodunu çözer. Örneğin, https://example.com/hello adresini kodlarsanız, https%3A%2F%2Fexample.com%2Fhello adresine dönüştürülür. Çözme işlemi ters yönde çalışır.
  • Base64 Kodla/Çöz: Bu, bir metni Base64 biçimine kodlar/çözer. Örneğin, hello kelimesini aGVsbG8= olarak kodlayabilir ve tekrar hello olarak çözebilirsiniz.
  • Tekrar Edenleri Değiştir: Bu, bir gruptaki bir veya daha fazla karakteri, bir Hedef ile eşleşenleri, bir Değişiklik ile değiştirir. Örneğin, Grup hello ise ve Hedef l ise ve Değişiklik y ise, heyyo olarak değiştirilir.
not

Bu, her yakalama grubunu işlemek içindir ve Hariç Tutulan URL Desenleri tarafından hariç tutulan URL'leri etkilemez. Örneğin, aşağıdaki kurala sahip olduğunuzu varsayalım:

  • Şuradan Yönlendir: https://example.com/(hello.*)
  • Yakalanan Grup İşleme:
    • Grup: $1
    • Hedef: .* (Düzenli İfade)
    • Değişiklik: hello
  • Hariç Tutulan URL Deseni: https://example.com/hello

Bu durumda, https://example.com/hello_world hariç tutulmazken, https://example.com/hello hariç tutulacaktır.

Hariç Tutulan URL Desenleri

Desteklenen Türler: Orijinal

Hariç Tutulan URL Desenleri seçeneği, yeniden yönlendirilmeyen URL'leri belirtmenize olanak tanır. Bu, yeniden yönlendirme döngülerinden kaçınmak veya bir web sitesinin belirli bölümlerini yeniden yönlendirmeden hariç tutmak için yararlı olabilir.

Hariç tutulan URL desenlerini Düzenli İfade veya Joker Karakter desen türlerini kullanarak belirtebilirsiniz.

Örnekler

Örnekler seçeneği, örnek URL'ler sağlayarak yeniden yönlendirme kuralınızı test etmenize olanak tanır. Örnek bir URL ekleyerek, kuralı gerçekten uygulamadan önce beklendiği gibi çalışıp çalışmadığını kontrol edebilirsiniz.

Yorumlar

Yorumlar seçeneği, yeniden yönlendirme kuralınız hakkında herhangi bir not veya yorum eklemenize olanak tanır. Bu, belirli bir kuralı neden oluşturduğunuzu takip etmek veya kurallarınızı görüntüleyebilecek diğer kişilere bağlam sağlamak için yararlı olabilir.

URL Deseni

Bir veya daha fazla URL deseni belirtebileceğiniz 3 seçenek vardır. Şuradan Yönlendir, Hariç Tutulan URL Desenleri ve Yakalanan Grup İşleme. Bunları belirtmek için, Joker Karakter veya Düzenli İfade arasından seçim yapabilirsiniz.

Joker Karakter

Joker Karakter, * (herhangi bir şeyle eşleşir) ve ? (herhangi bir tek karakterle eşleşir) joker karakter olarak kullanmanıza olanak tanıyan daha basit bir desen türüdür. İşte bazı örnekler:

  • https://example.com/hello ile eşleşmek için https://example.com/* kullanabilirsiniz. Bu, https://example.com/ adresinden sonraki herhangi bir dizeyle eşleşir.
  • https://example.com/search?q=hello ile eşleşmek için https://example.com/search?q=* kullanabilirsiniz. Bu, q parametresinin herhangi bir değeriyle eşleşir.
  • blog kelimesini içeren herhangi bir URL ile eşleşmek için *blog* kullanabilirsiniz.

Joker Karakter'de de ikame kullanabilirsiniz, bu da eşleşen URL'nin bölümlerini $1, $2, vb. kullanarak referans alabileceğiniz anlamına gelir. Örneğin, https://example.com/*-world-* kullanırsanız ve URL https://example.com/hello-world-goodbye ise, $1 "hello" ve $2 "goodbye" olacaktır. Eşleşen URL'nin tamamını referans almak için $0 da mevcuttur.

[!Note] İkame bir Düzenli İfade özelliği olsa da, Joker Karakter'de de kullanabilirsiniz çünkü Redirect Web dahili olarak Joker Karakter'i Düzenli İfade'ye dönüştürür.

Düzenli İfade

Düzenli İfade (Regex), Apple'ın burada açıklanan düzenli ifade motoru tarafından desteklenen, metindeki desenleri eşleştirmek için güçlü bir araçtır. Belirli bir dize kümesiyle eşleşen bir desen tanımlamanıza olanak tanır. İşte bazı örnekler.

  • https://example.com/hello ile eşleşmek için https://example.com/(.*) kullanabilirsiniz. Bu, https://example.com/ adresinden sonraki herhangi bir dizeyle eşleşir ve bunu bir yakalama grubunda saklar.
  • https://example.com/search?q=hello ile eşleşmek için https://example.com/search\?q=(.*) kullanabilirsiniz. Bu, q parametresinin değerini eşleştirir ve bunu bir yakalama grubunda saklar.
  • blog kelimesini içeren herhangi bir URL ile eşleşmek için .*blog.* kullanabilirsiniz.

Yakalama gruplarını Şuraya Yönlendir veya Değişiklik içinde $1, $2, ... kullanarak veya eşleşmenin tamamını referans almak için $0 kullanarak referans alabilirsiniz.

Regex sözdizimi hakkında daha fazla bilgiyi RegExr gibi kaynaklarda bulabilirsiniz.