Hoppa till huvudinnehåll

Chromium

isAlertOpen​

Om en enkel dialogruta är öppen för närvarande.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.isAlertOpen()
Exempel​
console.log(browser.isAlertOpen()); // skriver ut: false
browser.execute('window.alert()');
console.log(browser.isAlertOpen()); // skriver ut: true
Returnerar​
  • <Boolean> isAlertOpen: true eller false baserat på om en enkel dialogruta är närvarande eller inte.

isAutoReporting​

Om fel automatiskt ska genereras för webbläsarloggar.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.isAutoReporting()
Returnerar​
  • <Boolean> isAutoReporting: true eller false baserat på om automatisk rapportering är aktiverad.

setAutoReporting​

Växla om svaret ska returneras med okänt fel med första webbläsarfelet (t.ex. misslyckades att ladda resurs på grund av 403/404-svar) för alla efterföljande kommandon (när det är aktiverat).

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.setAutoReporting(enabled)
Parametrar​
NamnTypDetaljer
enabledbooleantrue om automatisk rapportering ska aktiveras, använd false för att inaktivera tidigare aktiverad automatisk rapportering.
Exempel​
// Aktivera automatisk rapportering direkt efter att sessionen startades med tomma webbläsarloggar
console.log(browser.setAutoReporting(true)); // skriver ut: null
// Vid begäran av en icke-befintlig resurs kommer den att avbryta körningen på grund av kastat okänt fel
browser.url('https://webdriver.io/img/404-does-not-exist.png');
// Under sessionen, utför några operationer som fyller webbläsarloggarna
browser.url('https://webdriver.io/img/404-does-not-exist.png');
browser.url('https://webdriver.io/403/no-access');
// Aktivera automatisk rapportering som kastar ett okänt fel för första webbläsarloggen (404-svar)
browser.setAutoReporting(true);
Returnerar​
  • <Object|Null> firstBrowserError: Om det första webbläsarfelet redan inträffade innan detta kommando kördes kommer det att kasta ett okänt fel som svar, vilket är ett objekt med 'message'-nyckeln som beskriver det första webbläsarfelet. Annars returnerar det null vid framgång.

isLoading​

Bestämmer laddningsstatus för aktivt fönsterhandtag.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.isLoading()
Exempel​
console.log(browser.isLoading()); // skriver ut: false
browser.newWindow('https://webdriver.io');
console.log(browser.isLoading()); // skriver ut: true
Returnerar​
  • <Boolean> isLoading: true eller false baserat på om aktivt fönsterhandtag laddar eller inte.

takeHeapSnapshot​

Tar en heap-snapshot av den aktuella exekveringskontexten.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.takeHeapSnapshot()
Returnerar​
  • <Object> heapSnapshot: En JSON-representation av heap-snapshot. Som kan inspekteras genom att laddas som fil i Chrome DevTools.

getNetworkConnection​

Hämta anslutningstypen för nätverksemulering. Detta kommando är endast tillämpligt när fjärrändpunkten svarar med networkConnectionEnabled-kapacitet inställd på true.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getNetworkConnection()
Exempel​
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // Nätverksemulering kräver enhetsläge, som endast är aktiverat när mobil emulering är på
            mobileEmulation: { deviceName: 'iPad' },
        },
    }
});
console.log(browser.getNetworkConnection()); // skriver ut: 6 (Både Wi-Fi och data)
Returnerar​
  • <Number> connectionType: En bitmask för att representera nätverksanslutningstypen. Flygplansläge (1), endast Wi-Fi (2), Wi-Fi och data (6), 4G (8), 3G (10), 2G (20). Som standard är Wi-Fi och data aktiverade.

setNetworkConnection​

Ändra anslutningstyp för nätverksanslutning. Detta kommando är endast tillämpligt när fjärrändpunkten svarar med networkConnectionEnabled-kapacitet inställd på true.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.setNetworkConnection(parameters)
Parametrar​
NamnTypDetaljer
parametersobjectObjekt som innehåller ConnectionType, ange bitmask som värde för type-nyckeln i objektet. Flygplansläge (1), endast Wi-Fi (2), Wi-Fi och data (6), 4G (8), 3G (10), 2G (20).
Exempel​
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // Nätverksemulering kräver enhetsläge, som endast är aktiverat när mobil emulering är på
            mobileEmulation: { deviceName: 'iPad' },
        },
    }
});
console.log(browser.setNetworkConnection({ type: 1 })); // skriver ut: 1 (Flygplansläge)
Returnerar​
  • <Number> connectionType: En bitmask för att representera nätverksanslutningstypen. Värdet bör matcha den angivna type i objektet, men enheten kanske inte är kapabel till den begärda nätverksanslutningstypen.

getNetworkConditions​

Hämta aktuella nätverksförhållanden som används för emulering.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getNetworkConditions()
Returnerar​
  • <Object> networkConditions: Objekt som innehåller nätverksförhållanden för offline, latency, download_throughput och upload_throughput. Nätverksförhållanden måste ställas in innan de kan hämtas.

setNetworkConditions​

Ställ in nätverksförhållanden som används för emulering genom att begränsa anslutningen.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.setNetworkConditions(network_conditions, network_name)
Parametrar​
NamnTypDetaljer
network_conditionsobjectObjekt som innehåller nätverksförhållanden som är latency, throughput (eller download_throughput/upload_throughput) och offline (valfritt).
network_name
valfri		stringNamn på nätverksbegränsningsförval. GPRS, Regular 2G, Good 2G, Regular 3G, Good 3G, Regular 4G, DSL, WiFi eller No throttling för att inaktivera. När förval anges respekteras inte värden som skickas i första argumentet.
Exempel​
// Använd olika nedladdnings- (25kb/s) och uppladdningsvärden (50kb/s) för begränsning med en latens på 1000ms
browser.setNetworkConditions({ latency: 1000, download_throughput: 25600, upload_throughput: 51200 });
// Tvinga frånkoppling från nätverk genom att ställa in 'offline' till true
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true });
// När förvalnamn (t.ex. 'DSL') anges respekteras inte värden i objektet (t.ex. 'offline')
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true }, 'DSL');
// Bästa praxis för att ange nätverksbegränsningsförval är att använda ett tomt objekt
browser.setNetworkConditions({}, 'Good 3G');

deleteNetworkConditions​

Inaktivera alla nätverksbegränsningar som kan ha ställts in. Motsvarande att ställa in förinställningen No throttling.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.deleteNetworkConditions()

sendCommand​

Skicka ett kommando till DevTools-felsökaren.
För en lista över tillgängliga kommandon och deras parametrar, se Chrome DevTools Protocol Viewer.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.sendCommand(cmd, params)
Parametrar​
NamnTypDetaljer
cmdstringNamn på kommandot (t.ex. Browser.close).
paramsobjectParametrar till kommandot. Om inga parametrar finns för kommandot, ange ett tomt objekt.

sendCommandAndGetResult​

Skicka ett kommando till DevTools-felsökaren och vänta på resultatet.
För en lista över tillgängliga kommandon och deras parametrar, se Chrome DevTools Protocol Viewer.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.sendCommandAndGetResult(cmd, params)
Parametrar​
NamnTypDetaljer
cmdstringNamn på kommandot som returnerar ett resultat (t.ex. Network.getAllCookies).
paramsobjectParametrar till kommandot. Om inga parametrar finns för kommandot, ange ett tomt objekt.
Returnerar​
  • <*> result: Antingen returvärdet för ditt kommando eller felet som var orsaken till att ditt kommando misslyckades.

file​

Ladda upp en fil till fjärrmaskinen på vilken webbläsaren körs.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.file(file)
Parametrar​
NamnTypDetaljer
filestringBase64-kodad zip-arkiv som innehåller en enda fil som ska laddas upp. Om base64-kodad data inte representerar ett zip-arkiv eller arkivet innehåller mer än en fil kommer det att kasta ett okänt fel.
Returnerar​
  • <String> path: Absolut sökväg till uppladdad fil på fjärrmaskinen.

launchChromeApp​

Startar en Chrome-app genom angivet id.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.launchChromeApp(id)
Parametrar​
NamnTypDetaljer
idstringTilläggs-id för appen som ska startas, enligt definitionen i chrome://extensions.
Exempel​
import fs from 'fs'
const browser = remote({
    capabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
            // Installera vid start av webbläsaren för att kunna starta den
            extensions: [
              // Posten ska vara en base64-kodad packad Chrome-app (.crx)
              fs.readFileSync('/absolute/path/app.crx').toString('base64')
            ]
        }
    }
});
browser.launchChromeApp('aohghmighlieiainnegkcijnfilokake')); // Google Docs (https://chrome.google.com/webstore/detail/docs/aohghmighlieiainnegkcijnfilokake)

getElementValue​

Hämtar värdet av ett givet formulärkontrollelement.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getElementValue(elementId)
Parametrar​
NamnTypDetaljer
elementIdStringid för elementet att hämta värde från
Returnerar​
  • <String|Null> value: Aktuellt värde för elementet. Om det angivna elementet inte är ett formulärkontrollelement kommer det att returnera null.

elementHover​

Aktivera hover-tillstånd för ett element, som återställs vid nästa interaktion.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.elementHover(elementId)
Parametrar​
NamnTypDetaljer
elementIdStringid för elementet att hovra över

touchPinch​

Utlöser en nyp-zoom-effekt.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.touchPinch(x, y, scale)
Parametrar​
NamnTypDetaljer
xnumberx-position att nypa på
ynumbery-position att nypa på
scalenumbernyp-zoom-skala

freeze​

Frys den aktuella sidan. Tillägg för Page Lifecycle API.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.freeze()

resume​

Återuppta den aktuella sidan. Tillägg för Page Lifecycle API.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.resume()

getCastSinks​

Returnerar listan över cast-sinks (Cast-enheter) tillgängliga för Chrome media router.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getCastSinks()
Returnerar​
  • <string[]> sinks: Lista över tillgängliga sinks.

selectCastSink​

Väljer en cast-sink (Cast-enhet) som mottagare av media router-intentioner (anslut eller spela).

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.selectCastSink(sinkName)
Parametrar​
NamnTypDetaljer
sinkNamestringNamnet på målenheten.

startCastTabMirroring​

Startar flikkspegning för den aktuella webbläsarfliken på den angivna enheten.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.startCastTabMirroring(sinkName)
Parametrar​
NamnTypDetaljer
sinkNamestringNamnet på målenheten.

getCastIssueMessage​

Returnerar felmeddelande om det finns något problem i en Cast-session.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getCastIssueMessage()
Returnerar​
  • <String> message: Felmeddelande, om något.

stopCasting​

Stoppar casting från media router till den angivna enheten, om ansluten.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.stopCasting(sinkName)
Parametrar​
NamnTypDetaljer
sinkNamestringNamnet på målenheten.

shutdown​

Stäng av ChromeDriver-processen och följaktligen avsluta alla aktiva sessioner.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.shutdown()

takeElementScreenshot​

Kommandot Ta Element-skärmdump tar en skärmdump av den synliga regionen som omfattas av elementets avgränsande rektangel.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.takeElementScreenshot(elementId, scroll)
Parametrar​
NamnTypDetaljer
elementIdStringid för ett element som returnerades i ett tidigare anrop till Find Element(s)
scroll
valfri		booleanrulla till elementets vy. Standard: true
Returnerar​
  • <String> screenshot: De base64-kodade PNG-bilddata som utgör skärmdumpen av den synliga regionen av ett elements avgränsande rektangel efter att den har rullats in i vyn.

getLogTypes​

Hämta tillgängliga loggtyper.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getLogTypes()
Returnerar​
  • <String[]> logTypes: Listan över tillgängliga loggtyper, till exempel browser, driver.

getLogs​

Hämta loggen för en given loggtyp. Loggbufferten återställs efter varje begäran.

Icke-officiellt och odokumenterat Chromium-kommando. Mer om detta kommando kan hittas här.

Användning​
browser.getLogs(type)
Parametrar​
NamnTypDetaljer
typestringloggtypen
Returnerar​
  • <Object[]> logs: Listan över loggposter.

Welcome! How can I help?

WebdriverIO AI Copilot