Kural Ayarları
Bu sayfa, Redirect Web uygulamasındaki Kuralı Düzenle ekranındaki her ayarın ayrıntılı bilgisini sağlar.
Seçenekler
Tür
Uygulamanın yönlendirmeyi nasıl ele alacağını kontrol etmek için Tür seçeneğini belirtin. Şunlardan birini seçebilirsiniz:
- Orijinal (Varsayılan)
- Bu, yönlendirmeyi kontrol etmek için geleneksel Web API'lerini kullanır. Ek olarak, bir geri dönüş için Sekmeler API'sini kullanır.
- Firefox'ta, yönlendirmeyi işlemek için WebRequest API'sini 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.
- Bu, yönlendirmeyi kontrol etmek için geleneksel Web API'lerini kullanır. Ek olarak, bir geri dönüş için Sekmeler API'sini kullanır.
- 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.
- ⚠️ Yakalama Grubu İşleme ve Hariç Tutulan URL Desenleri gibi bazı seçenekleri kullanamazsınız, çünkü bunlar henüz DNR API tarafından desteklenmemektedir.
- ⚠️ Safari'de, şu anda Normal İfade deseninize boru (
|
) ekleyemezsiniz. Ayrıntılar - ⚠️ Safari'nin DNR API'sinde hala bazı sorunlar olduğu için, 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, yönlendirmek istediğiniz web sayfalarının URL desenini belirtmenize olanak tanır. Joker Karakter veya Normal İfade seçebilirsiniz.
Örneğin, Joker Karakter ile https://example.com/*
belirtirseniz, https://example.com/
veya https://example.com/hello
ile eşleşir.
Şuraya Yönlendir seçeneğinde, $0
kullanarak tüm eşleşmeyi veya $1
, $2
, ... kullanarak kısmi eşleşmeleri referans alabilirsiniz. Ayrıntıları bu sayfadaki URL Deseni bölümünde kontrol edin.
Kaynak Türleri
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
ayarlarsanız, web sayfaları tarafından yüklenen JavaScript dosyalarını 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 üst düzey sayfa olan main_frame
'dir.
Her kaynak türünün ayrıntılarını lütfen mdn web belgelerinde kontrol edin.
İstek Yöntemleri
İ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ı lütfen mdn web belgelerinde kontrol edin.
Safari'de, Apple'ın DNR türü için uygulaması şu anda bunu ele almıyor gibi göründüğü için bu seçenek kullanılamayabilir. Apple'a FB14502272 olarak geri bildirim gönderdik.
Hedef Tarayıcılar
Hedef Tarayıcılar seçeneği, kuralın hangi tarayıcıya uygulanması gerektiğini 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ı tarafından belirtilen tarayıcılar: Açılır pencerede Ekle düğmesine dokunarak, Safari veya Safari Technology Preview dışındaki, Redirect Web uzantısı yüklü herhangi bir tarayıcıyı seçebilirsiniz.
- Seçilenler dışındaki tümü onay kutusu, seçtiğiniz tarayıcılar dışındaki her tarayıcıyı hedeflemenizi sağlar.
Redirect Web, tarayıcının Safari mi yoksa Safari Technology Preview mu olduğunu ayırt edemez, çünkü uygulama uzantının üst sürecini kontrol ederek bunu algılar, ancak bu iki tarayıcı aynı üst 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 yönlendirmek istediğiniz bir hedef URL'yi belirtir. Ayrıca $1
, $2
, ... ile yakalama gruplarını veya $0
ile tüm eşleşmeyi değiştirebilirsiniz. Bunlar, hedefi dinamik olarak belirtmenize yardımcı olur. Ayrıntıları bu sayfadaki URL Deseni bölümünde 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 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 Yakalama Grubu İşleme bölümünü kontrol edin.
Bir uygulamayı açmak için özel bir URL şeması belirtebilirsiniz. Bunlar derin bağlantıları destekleyen uygulamalara örneklerdir:
- 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
Hedef URL'yi açmak istediğiniz bir uygulamayı belirtmek isterseniz, Uygulama açılır kutusunu kullanın. Bu yalnızca macOS'ta mevcuttur.
Yalnızca Uygulama Korumalı Alanı destekleyen bir uygulamayı açabilirsiniz. Ayrıca, uygulamanın açmak istediğiniz URL'yi açmayı desteklediğinden emin olun.
Yakalama Grubu İşleme
Yakalama Grubu İşleme seçeneği, Şuraya Yönlendir seçeneğinde $1
, $2
... ile değiştirebileceğiniz yakalanan grupları nasıl işleyeceğinizi belirtmenize olanak tanır.
Yakalama grupları şu şekilde yapılır:
- Joker Karakter:
*
ve?
ile eşleşen metinler otomatik olarak yakalanır. - Normal İfade: Desen içindeki
()
ile 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 kodlama veya kod çözme uygular. Örneğin,
https://example.com/hello
kodlarsanız,https%3A%2F%2Fexample.com%2Fhello
olarak dönüştürülür. Kod çözme ters yönde çalışır. - Base64 Kodla/Çöz: Bu, bir metni Base64'e kodlar/çözer. Örneğin,
hello
'yuaGVsbG8=
olarak kodlayabilir vehello
olarak geri çözebilirsiniz. - Oluşumları Değiştir: Bu, bir gruptaki bir veya daha fazla karakteri, bir Hedef tarafından eşleşen, bir Değiştirme ile değiştirir. Örneğin, Grup
hello
ise ve Hedefl
ise ve Değiştirmey
ise,heyyo
olarak değiştirilir.
Bu, her yakalama grubunu işlemek içindir ve Hariç Tutulan URL Desenleri tarafından hariç tutulan URL'leri etkilemez. Örneğin, şu kuralınız olduğunu varsayalım:
- Şuradan Yönlendir:
https://example.com/(hello.*)
- Yakalama Grubu İşleme:
- Grup:
$1
- Hedef:
.*
(Normal İfade) - Değiştirme:
hello
- Grup:
- Hariç Tutulan URL Deseni:
https://example.com/hello
Bu durumda, https://example.com/hello_world
hariç tutulmayacakken https://example.com/hello
hariç tutulacaktır.
Hariç Tutulan URL Desenleri
Hariç Tutulan URL Desenleri seçeneği, yönlendirilmeyen URL'leri belirtmenize olanak tanır. Bu, yönlendirme döngülerini önlemek veya bir web sitesinin belirli bölümlerinin yönlendirilmesini hariç tutmak için yararlı olabilir.
Hariç tutulan URL desenlerini Normal İfade veya Joker Karakter desen türlerini kullanarak belirtebilirsiniz.
Örnekler
Örnekler seçeneği, örnek URL'ler sağlayarak yönlendirme kuralınızı test etmenize olanak tanır. Bir örnek URL ekleyerek, kuralın gerçekten uygulamadan önce beklendiği gibi çalışıp çalışmadığını kontrol edebilirsiniz.
Yorumlar
Yorumlar seçeneği, 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şiler için 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 Yakalama Grubu İşleme. Bunları belirtmek için Joker Karakter veya Normal İfade seçebilirsiniz.
Joker Karakter
Joker Karakter, *
(herhangi bir şeyi eşleştirir) ve ?
(herhangi bir tek karakteri eşleştirir) 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çinhttps://example.com/*
kullanabilirsiniz. Bu,https://example.com/
'den sonraki herhangi bir dizeyle eşleşecektir.https://example.com/search?q=hello
ile eşleşmek içinhttps://example.com/search?q=*
kullanabilirsiniz. Bu,q
parametresi için herhangi bir değerle eşleşecektir.blog
kelimesini içeren herhangi bir URL ile eşleşmek için*blog*
kullanabilirsiniz.
Joker Karakter'de de yerine koyma 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. $0
da eşleşen tüm URL'yi referans almak için kullanılabilir.
Yerine koyma, Normal İfade'nin bir özelliği olmasına rağmen, Redirect Web dahili olarak Joker Karakter'i Normal İfade'ye dönüştürdüğü için Joker Karakter için de kullanabilirsiniz.
Normal İfade
Normal İfade (Regex), burada açıklanan Apple'ın normal ifade motoru tarafından desteklenen, metinlerdeki desenleri eşleştirmek için güçlü bir araçtır. Bir dizi dizeyle eşleşen belirli bir desen tanımlamanıza olanak tanır. İşte bazı örnekler.
https://example.com/hello
ile eşleşmek içinhttps://example.com/(.*)
kullanabilirsiniz. Bu,https://example.com/
'den sonraki herhangi bir dizeyle eşleşecek ve onu bir yakalama grubunda saklayacaktır.https://example.com/search?q=hello
ile eşleşmek içinhttps://example.com/search\?q=(.*)
kullanabilirsiniz. Bu,q
parametresinin değerini eşleştirecek ve onu bir yakalama grubunda saklayacaktır.blog
kelimesini içeren herhangi bir URL ile eşleşmek için.*blog.*
kullanabilirsiniz.
Şuraya Yönlendir veya Değiştirme içinde yakalama gruplarını $1
, $2
, ... veya tüm eşleşmeyi referans almak için $0
kullanabilirsiniz.
Regex sözdizimi hakkında daha fazla bilgi RegExr gibi kaynaklarda bulunabilir.