browser Browser
Tarayıcı oturumlarını yönetir.
İşlemler (--action)
--action:open
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--url | metin | | |
--browser | şunlardan biri: default, chrome, edge, firefox | default | Açılacak tarayıcı; 'default' ajan makinesinin varsayılan tarayıcısını kullanır |
--headless | true / false | false | |
--output | değişken adı | | Bu tarayıcı için değişken; diğer web komutları onu --browser:$name$ ile hedefler |
--action:navigate
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--url zorunlu | metin | | |
Fare tekerleğini kullanıcının yapacağı gibi sayfanın ortasında çevirir (kaydırıldıkça daha fazla içerik yükleyen sayfalar da tepki verir).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--amount zorunlu | sayı | | Tekerlek adımları: pozitif yukarı, negatif aşağı kaydırır (bir adım yaklaşık 100 piksel) |
--action:close
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--action:refresh
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--action:back
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--action:forward
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--action:screenshot
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--screenshot zorunlu | metin | | Ekran görüntüsü dosya yolu Ajan makinesindeki bir dosya. |
--action:getcurrenturl
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:gettitle
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:executejs
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--script zorunlu | metin | | |
--output | değişken adı | | Sonucu alan değişken |
--action:newtab
Tarayıcıda yeni bir sekme açar; sonraki komutlar bu sekmede çalışır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--url | metin | | |
--action:switchtab
Komutların çalışacağı sekme olarak tarayıcının başka bir sekmesini (veya açılır penceresini) seçer; bundan sonra --browser:$variable$ o sekme anlamına gelir.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--title | metin | | Sekmenin başlığı (joker karakterler: *Invoice*) |
--url | metin | | Sekmenin adresi (joker karakterler: *orders/new*); başlıkla birlikte veya başlık yerine kullanılır |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--action:closetab
Geçerli sekmeyi kapatır; önceki sekme geçerli olur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--action:gettabs
Tarayıcının sekmeleri, kayıt olarak (Title, Url, IsCurrent).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:ondialog
Sayfaların alert, confirm ve prompt iletişim kutularının bundan sonra nasıl yanıtlanacağı. Bu komut olmadan kapatılırlar (Cancel).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--accept | true / false | true | true OK, false Cancel yanıtı verir |
--text | metin | | prompt iletişim kutularına yazılan metin |
--action:getlastdialog
Bir sayfanın gösterdiği son iletişim kutusunun mesajı.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getcookies
Tarayıcının çerezleri, kayıt olarak (Name, Value, Domain, Path, Expires).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setcookie
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--name zorunlu | metin | | |
--value zorunlu | metin | | |
--domain | metin | | Çerezin ait olduğu site; boşsa geçerli sayfanın sitesi |
--path | metin | / | |
--action:clearcookies
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
Örnekler
browser --action:open --url:"https://example.com" --output:session
browser --action:navigate --url:"https://other.com"
browser --action:close
browser --action:open --url:"https://shop.example.com" --output:shop
browser --action:open --url:"https://erp.local" --output:erp
capture --browser:$shop$ --action:gettext --dompath:"#price" --output:price
capture --browser:$erp$ --action:settext --dompath:"#amount" --value:$price$
browser --browser:$shop$ --action:close
browser --action:newtab --url:"https://example.com/orders"
browser --browser:$shop$ --action:switchtab --title:"*Invoice*" --timeout:10
browser --action:switchtab --url:"*orders/new*"
browser --action:closetab
browser --action:gettabs --output:tabs
browser --action:ondialog --accept:true --text:"duplicate order"
browser --action:getlastdialog --output:message
browser --action:setcookie --name:session --value:$token$ --domain:"example.com"
browser --action:getcookies --output:cookies
browser --action:clearcookies
capture Capture
Bir web sayfası elementiyle etkileşim kurar.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--window | $değişken$ | | Başlığa göre tarayıcı penceresi (bir set --type:window değişkeni); --browser verilmediğinde kullanılır |
--browser | $değişken$ | | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--dompath zorunlu | metin | | XPath veya CSS seçici |
--frame | metin | | Elementin bulunduğu iframe'in seçicisi, ör. #payment; iç içe çerçeveler outer >> inner şeklinde. Boşsa sayfanın kendisi |
--properties | metin | | Yakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur |
--anchor | metin | | Yakında bulunan ve değişmeyen bir elementin (etiket, başlık) seçicisi; --dompath için birden çok eşleşme varsa ona en yakın olan kullanılır |
--anchorposition | şunlardan biri: near, right, left, below, above | near | Elementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır |
--fallback | metin | | İlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--retry | sayı | | Yeniden deneme sayısı. Belirtilmezse ekran ve dosya komutları geçici bir sorundan (hâlâ yüklenen bir sayfa, örtülü bir öğe, kilitli bir dosya) sonra bir kez daha dener; 0 bunu kapatır |
--retryinterval | sayı | 1 | Yeniden denemeler arasındaki saniye |
İşlemler (--action)
--action:click
Başka parametre yok.
--action:doubleclick
Başka parametre yok.
--action:rightclick
Başka parametre yok.
--action:clear
Başka parametre yok.
--action:check
Başka parametre yok.
--action:uncheck
Başka parametre yok.
--action:hover
Başka parametre yok.
--action:focus
Başka parametre yok.
--action:submit
Başka parametre yok.
--action:waitfor
Başka parametre yok.
--action:settext
Bir alanın metnini değiştirir (eski adı: type).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
--action:appendtext
Bir alanda zaten bulunan metnin sonuna metin ekler.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
Fare tekerleğini element üzerinde çevirir: sayfa içinde kayan listeler, paneller ve tablolar için.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--amount zorunlu | sayı | | Tekerlek adımları: pozitif yukarı, negatif aşağı kaydırır (bir adım yaklaşık 100 piksel) |
--action:sendkeys
Elemente odaklanır ve klavyenin yapacağı gibi orada tuşlara basar: metin, özel tuşlar ve kısayollar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--keys zorunlu | tuşlar | | Metin ve köşeli parantez içinde özel tuşlar, ör. [TAB], [ESC], [CTRL+A], [DOWN][ENTER]. Düz bir [ için [[ kullanın |
--action:select
Açılır listedeki bir seçeneği değerine veya metnine göre seçer.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
--action:selectindex
Açılır listede belirli bir sıradaki seçeneği seçer.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--index zorunlu | sayı | | Seçeneğin sırası: 1 = ilk |
--action:getproperty
Elementin bir özelliğini, bir durumunu (visible, enabled, checked), seçili seçeneğini veya konumunu okur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--property zorunlu | metin | | value, text, visible, checked, selectedtext, x, … veya herhangi bir öznitelik |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setproperty
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--property zorunlu | metin | | value, text, innerhtml veya herhangi bir öznitelik |
--value zorunlu | metin | | |
--action:getattribute
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--property zorunlu | metin | | Öznitelik adı |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:gettext
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:exists
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:gettable
Bir HTML tablosunu veri tablosu değişkenine okur: tabloyu, hücrelerinden birini veya onu içeren bir elementi yakalayın. Satırlar üzerinde loop --type:datatable ile döngü kurun.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--header | true / false | true | Başlık satırı (thead, yoksa ilk satır) sütunları adlandırır; false: Column1, Column2… ve her satır veridir |
--output zorunlu | değişken adı | | Sonucu alan değişken |
Tekrarlayan öğeleri (ürün kartları, arama sonuçları, liste satırları) bir veri tablosuna okur: --dompath her öğeyle eşleşir, her sütun bir öğenin içindeki bir değeri okur ve --next sayfaları çevirir. Extract data sihirbazıyla oluşturulur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--columns zorunlu | metin | | JSON olarak sütunlar: [{"name":"Title","path":".//h3","read":"text"}]. path öğeye görelidir (. öğenin kendisidir); read değeri text, value, href, src, html veya herhangi bir öznitelik adıdır |
--next | metin | | Sonraki sayfa düğmesinin veya bağlantısının seçicisi: her sayfa okunduktan sonra, bulunamayana veya devre dışı kalana kadar tıklanır. Boşsa tek sayfa okunur |
--maxpages | sayı | 10 | Okunacak en fazla sayfa sayısı (--next ile) |
--maxrows | sayı | 0 | Okunacak en fazla satır sayısı; 0 hepsini okur |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:screenshot
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--path zorunlu | metin | | Ekran görüntüsü dosya yolu Ajan makinesindeki bir dosya. |
--action:upload
Yükleme için dosya seçer: bir dosya girişinde veya dosya iletişim kutusunu açan düğmede.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Yüklenecek dosya; birden fazlası virgülle ayrılır Ajan makinesindeki bir dosya. |
--action:download
Elemente tıklar ve sitenin ardından indirdiği dosyayı kaydeder; --output kaydedilen dosyayı alır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--path zorunlu | metin | | Kaydedilecek dosya veya bir klasör (sitenin dosya adı kullanılır) Ajan makinesindeki bir dosya. |
--output | değişken adı | | Sonucu alan değişken |
Örnekler
capture --action:click --dompath:"//button[@id='login']"
capture --action:settext --dompath:"//input[@name='email']" --value:"user@test.com"
capture --action:getproperty --dompath:"//h1" --property:text --output:pageTitle
capture --action:select --dompath:"//select[@id='country']" --value:"Turkey"
capture --action:selectindex --dompath:"//select[@id='country']" --index:2
capture --action:appendtext --dompath:"#note" --value:" (urgent)"
capture --action:getproperty --dompath:"#agree" --property:checked --output:agreed
capture --action:exists --dompath:"//div[@class='error']" --output:hasError
capture --action:click --frame:"#payment" --dompath:"#pay"
capture --action:upload --dompath:"input[type=file]" --file:"C:\a.pdf, C:\b.pdf"
capture --action:download --dompath:"#export" --path:"C:\Downloads" --output:file
capture --action:gettable --dompath:"#orders" --output:orders
capture --action:extract --dompath:"//div[@id='results']/ul/li/div" --columns:[{"name":"Title","path":".//h3","read":"text"},{"name":"Price","path":".//span[@class='price']","read":"text"},{"name":"Link","path":".//a","read":"href"}] --next:"//a[normalize-space()='Next']" --maxpages:10 --output:products