Hoppa till huvudinnehåll

Drivrutinsbinärer

För att köra automatisering baserad på WebDriver-protokollet behöver du ha webbläsardrivrutiner installerade som översätter automatiseringskommandon och kan utföra dem i webbläsaren.

Automatiserad installation​

Med WebdriverIO v8.14 och senare finns det inte längre behov av att manuellt ladda ner och installera några webbläsardrivrutiner eftersom detta hanteras av WebdriverIO. Allt du behöver göra är att ange vilken webbläsare du vill testa och WebdriverIO gör resten.

Anpassa graden av automatisering​

WebdriverIO har tre nivåer av automatisering:

1. Ladda ner och installera webbläsaren med hjälp av @puppeteer/browsers.

Om du anger en browserName/browserVersion-kombination i capabilities-konfigurationen, kommer WebdriverIO att ladda ner och installera den begärda kombinationen, oavsett om det finns en befintlig installation på datorn. Om du utelämnar browserVersion kommer WebdriverIO först att försöka hitta och använda en befintlig installation med locate-app, annars kommer den att ladda ner och installera den aktuella stabila webbläsarversionen. För mer information om browserVersion, se här.

varning

Automatiserad webbläsarinställning stöder inte Microsoft Edge. För närvarande stöds endast Chrome, Chromium och Firefox.

Om du har en webbläsarinstallation på en plats som inte kan upptäckas automatiskt av WebdriverIO, kan du ange webbläsarbinärer vilket inaktiverar den automatiska nedladdningen och installationen.

{
    capabilities: [
        {
            browserName: 'chrome', // eller 'firefox' eller 'chromium'
            'goog:chromeOptions': { // eller 'moz:firefoxOptions' eller 'wdio:chromedriverOptions'
                binary: '/path/to/chrome'
            },
        }
    ]
}

2. Ladda ner och installera drivrutinen med hjälp av Chromedriver, Edgedriver eller Geckodriver.

WebdriverIO kommer alltid att göra detta, såvida inte drivrutinens binary specificeras i konfigurationen:

{
    capabilities: [
        {
            browserName: 'chrome', // eller 'firefox', 'msedge', 'safari', 'chromium'
            'wdio:chromedriverOptions': { // eller 'wdio:geckodriverOptions', 'wdio:edgedriverOptions'
                binary: '/path/to/chromedriver' // eller 'geckodriver', 'msedgedriver'
            }
        }
    ]
}
info

WebdriverIO kommer inte att automatiskt ladda ner Safari-drivrutinen eftersom den redan är installerad på macOS.

varning

Undvik att ange en binary för webbläsaren och utelämna motsvarande drivrutins binary eller vice versa. Om endast ett av binary-värdena anges kommer WebdriverIO att försöka använda eller ladda ner en kompatibel webbläsare/drivrutin. I vissa scenarier kan det dock resultera i en inkompatibel kombination. Därför rekommenderas att du alltid anger båda för att undvika problem orsakade av versionsinkompatibiliteter.

3. Starta/stoppa drivrutinen.

Som standard kommer WebdriverIO automatiskt att starta och stoppa drivrutinen med hjälp av en godtycklig oanvänd port. Att ange något av följande konfigurationer kommer att inaktivera denna funktion, vilket innebär att du måste starta och stoppa drivrutinen manuellt:

Manuell installation​

Följande beskriver hur du fortfarande kan installera varje drivrutin individuellt. Du hittar en lista med alla drivrutiner i awesome-selenium README.

tips

Om du letar efter att installera mobila och andra UI-plattformar, ta en titt på vår Appium Setup guide.

Chromedriver​

För att automatisera Chrome kan du ladda ner Chromedriver direkt från projektets webbplats eller genom NPM-paketet:

npm install -g chromedriver

Du kan sedan starta det via:

chromedriver --port=4444 --verbose

Geckodriver​

För att automatisera Firefox, ladda ner den senaste versionen av geckodriver för din miljö och packa upp den i din projektmapp:

npm install geckodriver

Obs: Andra geckodriver-releaser finns tillgängliga här. Efter nedladdning kan du starta drivrutinen via:

/path/to/binary/geckodriver --port 4444

Edgedriver​

Du kan ladda ner drivrutinen för Microsoft Edge på projektets webbplats eller som NPM-paket via:

npm install -g edgedriver
edgedriver --version # prints: Microsoft Edge WebDriver 115.0.1901.203 (a5a2b1779bcfe71f081bc9104cca968d420a89ac)

Safaridriver​

Safaridriver kommer förinstallerat på din MacOS och kan startas direkt via:

safaridriver -p 4444

Welcome! How can I help?

WebdriverIO AI Copilot