Tarayıcı Otomasyonu

icc browser komut grubu, icc tarayıcı yüzeylerine karşı tarayıcı otomasyonu sağlar. Gezinmek, DOM öğeleriyle etkileşim kurmak, sayfa durumunu incelemek, JavaScript değerlendirmek ve tarayıcı oturum verilerini yönetmek için kullanın.

Komut İndeksi

Kategori	Alt komutlar
Gezinme ve hedefleme	`identify`, `open`, `open-split`, `navigate`, `back`, `forward`, `reload`, `url`, `focus-webview`, `is-webview-focused`
Bekleme	`wait`
DOM etkileşimi	`click`, `dblclick`, `hover`, `focus`, `check`, `uncheck`, `scroll-into-view`, `type`, `fill`, `press`, `keydown`, `keyup`, `select`, `scroll`
İnceleme	`snapshot`, `screenshot`, `get`, `is`, `find`, `highlight`
JavaScript ve enjeksiyon	`eval`, `addinitscript`, `addscript`, `addstyle`
Çerçeveler, diyaloglar, indirmeler	`frame`, `dialog`, `download`
Durum ve oturum verileri	`cookies`, `storage`, `state`
Sekmeler ve günlükler	`tab`, `console`, `errors`

Tarayıcı yüzeyini hedefleme

Çoğu alt komut bir hedef yüzey gerektirir. Konumsal olarak veya --surface ile geçirebilirsiniz.

# Open a new browser split
icc browser open https://example.com

# Discover focused IDs and browser metadata
icc browser identify
icc browser identify --surface surface:2

# Positional vs flag targeting are equivalent
icc browser surface:2 url
icc browser --surface surface:2 url

Gezinme

icc browser open https://example.com
icc browser open-split https://news.ycombinator.com

icc browser surface:2 navigate https://example.org/docs --snapshot-after
icc browser surface:2 back
icc browser surface:2 forward
icc browser surface:2 reload --snapshot-after
icc browser surface:2 url

icc browser surface:2 focus-webview
icc browser surface:2 is-webview-focused

Bekleme

Seçiciler, metin, URL parçaları, yükleme durumu veya bir JavaScript koşulu karşılanana kadar engellemek için wait kullanın.

icc browser surface:2 wait --load-state complete --timeout-ms 15000
icc browser surface:2 wait --selector "#checkout" --timeout-ms 10000
icc browser surface:2 wait --text "Order confirmed"
icc browser surface:2 wait --url-contains "/dashboard"
icc browser surface:2 wait --function "window.__appReady === true"

DOM Etkileşimi

Değiştirici eylemler, betiklerde hızlı doğrulama için --snapshot-after'ı destekler.

icc browser surface:2 click "button[type='submit']" --snapshot-after
icc browser surface:2 dblclick ".item-row"
icc browser surface:2 hover "#menu"
icc browser surface:2 focus "#email"
icc browser surface:2 check "#terms"
icc browser surface:2 uncheck "#newsletter"
icc browser surface:2 scroll-into-view "#pricing"

icc browser surface:2 type "#search" "icc"
icc browser surface:2 fill "#email" --text "[email protected]"
icc browser surface:2 fill "#email" --text ""
icc browser surface:2 press Enter
icc browser surface:2 keydown Shift
icc browser surface:2 keyup Shift
icc browser surface:2 select "#region" "us-east"
icc browser surface:2 scroll --dy 800 --snapshot-after
icc browser surface:2 scroll --selector "#log-view" --dx 0 --dy 400

İnceleme

Betikler için yapılandırılmış getter'lar ve insan incelemesi için anlık görüntüler/ekran görüntüleri kullanın.

icc browser surface:2 snapshot --interactive --compact
icc browser surface:2 snapshot --selector "main" --max-depth 5
icc browser surface:2 screenshot --out /tmp/icc-page.png

icc browser surface:2 get title
icc browser surface:2 get url
icc browser surface:2 get text "h1"
icc browser surface:2 get html "main"
icc browser surface:2 get value "#email"
icc browser surface:2 get attr "a.primary" --attr href
icc browser surface:2 get count ".row"
icc browser surface:2 get box "#checkout"
icc browser surface:2 get styles "#total" --property color

icc browser surface:2 is visible "#checkout"
icc browser surface:2 is enabled "button[type='submit']"
icc browser surface:2 is checked "#terms"

icc browser surface:2 find role button --name "Continue"
icc browser surface:2 find text "Order confirmed"
icc browser surface:2 find label "Email"
icc browser surface:2 find placeholder "Search"
icc browser surface:2 find alt "Product image"
icc browser surface:2 find title "Open settings"
icc browser surface:2 find testid "save-btn"
icc browser surface:2 find first ".row"
icc browser surface:2 find last ".row"
icc browser surface:2 find nth 2 ".row"

icc browser surface:2 highlight "#checkout"

JavaScript Değerlendirme ve Enjeksiyon

icc browser surface:2 eval "document.title"
icc browser surface:2 eval --script "window.location.href"

icc browser surface:2 addinitscript "window.__iccReady = true;"
icc browser surface:2 addscript "document.querySelector('#name')?.focus()"
icc browser surface:2 addstyle "#debug-banner { display: none !important; }"

Durum

Oturum verisi komutları çerezleri, yerel/oturum depolamasını ve tam tarayıcı durumu anlık görüntülerini kapsar.

icc browser surface:2 cookies get
icc browser surface:2 cookies get --name session_id
icc browser surface:2 cookies set session_id abc123 --domain example.com --path /
icc browser surface:2 cookies clear --name session_id
icc browser surface:2 cookies clear --all

icc browser surface:2 storage local set theme dark
icc browser surface:2 storage local get theme
icc browser surface:2 storage local clear
icc browser surface:2 storage session set flow onboarding
icc browser surface:2 storage session get flow

icc browser surface:2 state save /tmp/icc-browser-state.json
icc browser surface:2 state load /tmp/icc-browser-state.json

Sekmeler

Tarayıcı sekmesi işlemleri, aktif tarayıcı sekmesi grubundaki tarayıcı yüzeylerine karşılık gelir.

icc browser surface:2 tab list
icc browser surface:2 tab new https://example.com/pricing

# Switch by index or by target surface
icc browser surface:2 tab switch 1
icc browser surface:2 tab switch surface:7

# Close current tab or a specific target
icc browser surface:2 tab close
icc browser surface:2 tab close surface:7

Konsol ve Hatalar

icc browser surface:2 console list
icc browser surface:2 console clear

icc browser surface:2 errors list
icc browser surface:2 errors clear

Diyaloglar

icc browser surface:2 dialog accept
icc browser surface:2 dialog accept "Confirmed by automation"
icc browser surface:2 dialog dismiss

Çerçeveler

# Enter an iframe context
icc browser surface:2 frame "iframe[name='checkout']"
icc browser surface:2 click "#pay-now"

# Return to the top-level document
icc browser surface:2 frame main

İndirmeler

icc browser surface:2 click "a#download-report"
icc browser surface:2 download --path /tmp/report.csv --timeout-ms 30000

Yaygın Kalıplar

Gezin, bekle, incele

icc browser open https://example.com/login
icc browser surface:2 wait --load-state complete --timeout-ms 15000
icc browser surface:2 snapshot --interactive --compact
icc browser surface:2 get title

Bir formu doldurun ve başarı metnini doğrulayın

icc browser surface:2 fill "#email" --text "[email protected]"
icc browser surface:2 fill "#password" --text "$PASSWORD"
icc browser surface:2 click "button[type='submit']" --snapshot-after
icc browser surface:2 wait --text "Welcome"
icc browser surface:2 is visible "#dashboard"

Başarısızlıkta debug artefaktlarını yakalayın

icc browser surface:2 console list
icc browser surface:2 errors list
icc browser surface:2 screenshot --out /tmp/icc-failure.png
icc browser surface:2 snapshot --interactive --compact

Tarayıcı oturumunu kaydet ve geri yükle

icc browser surface:2 state save /tmp/session.json
# ...later...
icc browser surface:2 state load /tmp/session.json
icc browser surface:2 reload