Ontdek manieren om gebruikersstromen te delen, deze en hun stappen te bewerken in deze uitgebreide referentie over de functies van het Chrome DevTools Recorder- paneel.
Zie Gebruikersstromen opnemen, opnieuw afspelen en meten voor meer informatie over de basisprincipes van het werken met het Recorder -paneel.
Sneltoetsen leren en aanpassen
Gebruik snelkoppelingen om sneller door de Recorder te navigeren. Zie Sneltoetsen op het recorderpaneel voor een lijst met standaardsneltoetsen.
Als u een hint wilt openen waarin alle snelkoppelingen rechtstreeks in de Recorder worden vermeld, klikt u op
Snelkoppelingen weergeven in de rechterbovenhoek.Recordersnelkoppelingen aanpassen:
- Open Instellingen > Snelkoppelingen .
- Blader omlaag naar het gedeelte Recorder .
- Volg de stappen in Snelkoppelingen aanpassen.
Gebruikersstromen bewerken
Bovenaan het Recorder- paneel vindt u opties waarmee u het volgende kunt doen:
- Voeg een nieuwe opname toe . Klik op het + icoon om een nieuwe opname toe te voegen .
- Bekijk alle opnames . De vervolgkeuzelijst toont de lijst met opgeslagen opnamen. Selecteer de optie N opname(s) om de lijst met opgeslagen opnames uit te breiden en te beheren.
Exporteer een opname . Als u het script verder wilt aanpassen of delen voor bugrapportagedoeleinden, kunt u de gebruikersstroom in een van de volgende indelingen exporteren:
- JSON-bestand.
- @puppeteer/replay- script.
- Poppenspeler script.
- Poppenspeler-script (voor Firefox) .
- Poppenspeler (inclusief Lighthouse -analyse).
Zie Een gebruikersstroom exporteren voor meer informatie over de indelingen.
Importeer een opname . Alleen in JSON-formaat.
Verwijder een opname . Verwijder de geselecteerde opname.
U kunt de naam van de opname ook bewerken door op de knop Bewerken te klikken ernaast.
Deel gebruikersstromen
U kunt gebruikersstromen exporteren en importeren in de Recorder. Dit is handig voor het rapporteren van bugs, omdat u een exact overzicht kunt delen van de stappen die een bug reproduceren. U kunt het ook exporteren en opnieuw afspelen met externe bibliotheken.
Exporteer een gebruikersstroom
Een gebruikersstroom exporteren:
- Open de gebruikersstroom die u wilt exporteren.
Klik op
Exporteren bovenaan het Recorder- paneel.Selecteer een van de volgende formaten in de vervolgkeuzelijst:
- JSON-bestand . Download de opname als JSON-bestand.
- @poppenspeler/herhaling . Download de opname als een Puppeteer Replay- script.
- Poppenspeler . Download de opname als poppenspelerscript .
- Poppenspeler (voor Firefox) . Download de opname als een Puppeteer voor Firefox- script.
- Poppenspeler (inclusief Lighthouse-analyse) . Download de opname als een poppenspelerscript met een ingebouwde Lighthouse -analyse.
- Een of meer opties die worden geboden door de Export-extensies van de Recorder.
Sla het bestand op.
Met elke standaard exportoptie kunt u het volgende doen:
- JSON . Bewerk het voor mensen leesbare JSON-object en importeer het JSON-bestand terug naar de Recorder .
- @poppenspeler/herhaling . Speel het script opnieuw af met de Puppeteer Replay- bibliotheek. Bij het exporteren als @puppeteer/replay-script blijven de stappen een JSON-object. Deze optie is perfect als u wilt integreren met uw CI/CD-pijplijn, maar toch de flexibiliteit hebt om de stappen als JSON te bewerken, ze later te converteren en weer in de Recorder te importeren.
- Poppenspeler script . Speel het script opnieuw af met Puppeteer . Omdat de stappen worden omgezet in JavaScript, kunt u gedetailleerdere aanpassingen uitvoeren, bijvoorbeeld door de stappen in een lus te plaatsen. Eén waarschuwing: u kunt dit script niet terug importeren in de Recorder .
- Poppenspeler (voor Firefox) . Als onderdeel van WebDriver BiDi- ondersteuning kunt u dit Puppeteer-script zowel in Chrome als in Firefox uitvoeren.
Poppenspeler (inclusief Lighthouse-analyse) . Deze exportoptie is hetzelfde als de vorige, maar bevat code die een Lighthouse -analyse genereert.
Voer het script uit en bekijk de uitvoer in een
flow.report.html
-bestand:# npm i puppeteer lighthouse node your_export.js
Exporteer in een aangepast formaat door een extensie te installeren
Zie Recorderextensies .
Importeer een gebruikersstroom
Een gebruikersstroom importeren:
- Klik op Importeren knop bovenaan het Recorderpaneel .
- Selecteer het JSON-bestand met de opgenomen gebruikersstroom.
- Klik op de Knop Opnieuw afspelen om de geïmporteerde gebruikersstroom uit te voeren.
Opnieuw afspelen met externe bibliotheken
The Puppeteer Replay is een open source-bibliotheek die wordt onderhouden door het Chrome DevTools-team. Het is gebouwd bovenop Puppeteer . Het is een opdrachtregelprogramma, u kunt er JSON-bestanden mee afspelen.
Afgezien daarvan kunt u JSON-bestanden transformeren en opnieuw afspelen met de volgende bibliotheken van derden.
Transformeer JSON-gebruikersstromen naar aangepaste scripts:
- Cypress Chrome-recorder . U kunt het gebruiken om JSON-bestanden van gebruikersstromen naar Cypress-testscripts te converteren. Bekijk deze demo om hem in actie te zien.
- Nachtwacht Chrome Recorder . U kunt het gebruiken om JSON-bestanden van gebruikersstromen naar Nightwatch-testscripts te converteren.
- CodeceptJS Chrome-recorder . U kunt het gebruiken om JSON-bestanden van gebruikersstromen naar CodeceptJS-testscripts te converteren.
JSON-gebruikersstromen opnieuw afspelen:
- Opnieuw afspelen met Testcafe . U kunt TestCafe gebruiken om JSON-bestanden van gebruikersstromen opnieuw af te spelen en testrapporten voor deze opnamen te genereren.
- Opnieuw spelen met Sauce Labs . U kunt de JSON-bestanden op Sauce Labs opnieuw afspelen met behulp van sausctl .
Foutopsporing in gebruikersstromen
Zoals bij elke code moet u soms fouten opsporen in de opgenomen gebruikersstromen.
Om u te helpen bij het opsporen van fouten, kunt u in het Recorder- paneel de herhalingen vertragen, breekpunten instellen, de uitvoering stapsgewijs doorlopen en code in verschillende formaten parallel met stappen inspecteren.
Vertraag de herhaling
Standaard herhaalt de Recorder de gebruikersstroom zo snel mogelijk. Om te begrijpen wat er in de opname gebeurt, kunt u de afspeelsnelheid vertragen:
- Open de Vervolgkeuzemenu Opnieuw afspelen .
- Kies een van de opties voor afspeelsnelheid:
- Normaal (standaard)
- Langzaam
- Heel langzaam
- Extreem langzaam
Code inspecteren
De code van een gebruikersstroom in verschillende formaten inspecteren:
- Open een opname in het Recorder- paneel.
- Klik op Code weergeven in de rechterbovenhoek van de stappenlijst.
- De Recorder toont een zij-aan-zij weergave van de stappen en hun code.
- Terwijl u over een stap zweeft, markeert de Recorder de betreffende code in elk formaat, inclusief die van extensies .
Vouw de vervolgkeuzelijst Indeling uit om een indeling te selecteren die u gebruikt om gebruikersstromen te exporteren .
Het kan een van de drie standaardformaten zijn (JSON, @puppeteer/replay , Puppeteer-script of een formaat dat wordt geleverd door een extensie .
Ga verder met het debuggen van uw opname door stapparameters en -waarden te bewerken . De codeweergave kan niet worden bewerkt, maar wordt dienovereenkomstig bijgewerkt wanneer u wijzigingen aanbrengt in de stappen aan de linkerkant.
Stel breekpunten in en voer deze stap voor stap uit
Een breekpunt instellen en stap voor stap uitvoeren:
- Beweeg over de cirkel naast een stap in een opname. De cirkel verandert in een breekpuntpictogram.
- Klik op de breekpuntpictogram en speel de opname opnieuw af . De uitvoeringen pauzeren op het breekpunt.
- Om de uitvoering te doorlopen, klikt u op de Voer één stapknop uit op de actiebalk bovenaan het Recorder- paneel.
- Om het opnieuw afspelen te stoppen, klikt u op Annuleer het opnieuw afspelen .
Stappen bewerken
U kunt elke stap in de opname bewerken door op de knop te klikken knop ernaast, zowel tijdens de opname als daarna.
U kunt ook ontbrekende stappen toevoegen en per ongeluk opgenomen stappen verwijderen .
Voeg stappen toe
Soms moet u mogelijk handmatig stappen toevoegen. De Recorder legt bijvoorbeeld niet automatisch hover
vast, omdat dit de opname vervuilt en niet al deze gebeurtenissen nuttig zijn. UI-elementen, zoals vervolgkeuzemenu's, kunnen echter alleen verschijnen als u met hover
. U kunt handmatig hover
toevoegen aan gebruikersstromen die afhankelijk zijn van dergelijke elementen.
Handmatig een stap toevoegen:
- Open deze demopagina en start een nieuwe opname.
- Beweeg over het element in de viewport. Er verschijnt een actiemenu.
- Kies een actie uit het menu en beëindig de opname. De Recorder legt alleen de klikgebeurtenis vast.
- Probeer de opname opnieuw af te spelen door op te klikken Opnieuw afspelen . Het opnieuw afspelen mislukt na een time-out omdat de recorder geen toegang heeft tot het element in het menu.
- Klik op de knop met drie stippen naast de klikstap en selecteer Stap toevoegen vóór .
- Vouw de nieuwe stap uit. Standaard heeft het het type
waitForElement
. Klik op de waarde naasttype
en selecteerhover
. - Stel vervolgens een geschikte selector in voor de nieuwe stap. Klik Selecteer en klik vervolgens op een gebied met de
Hover over me!
element dat zich buiten het pop-upmenu bevindt. De selector is ingesteld op#clickable
. - Probeer de opname opnieuw af te spelen. Met de toegevoegde hover-stap herhaalt de Recorder de stroom met succes.
Voeg beweringen toe
Tijdens de opname kunt u bijvoorbeeld HTML-attributen en JavaScript-eigenschappen vastleggen. Om een bewering toe te voegen:
- Start bijvoorbeeld een opname op deze demopagina .
Klik op Bewering toevoegen .
De Recorder maakt een configureerbare
waitForElement
-stap.Geef selectors op voor deze stap.
Configureer de stap , maar wijzig het
waitForElement
-type niet. U kunt bijvoorbeeld het volgende opgeven:- HTML-attribuut . Klik op Attributen toevoegen en typ de naam en waarde van het attribuut die door de elementen op deze pagina worden gebruikt. Bijvoorbeeld
data-test: <value>
. - JavaScript-eigenschap . Klik op Eigenschappen toevoegen en typ de naam en waarde van de eigenschap in JSON-indeling. Bijvoorbeeld
{".innerText":"<text>"}
. - Andere stapeigenschappen . Bijvoorbeeld
visible: true
.
- HTML-attribuut . Klik op Attributen toevoegen en typ de naam en waarde van het attribuut die door de elementen op deze pagina worden gebruikt. Bijvoorbeeld
Ga verder met het opnemen van de rest van de gebruikersstroom en stop vervolgens de opname.
Klik Opnieuw afspelen . Als een bewering mislukt, geeft de Recorder na een time-out een fout weer.
Bekijk de volgende video om deze workflow in actie te zien.
Kopieer stappen
In plaats van de gehele gebruikersstroom te exporteren , kunt u een enkele stap naar het klembord kopiëren:
- Klik met de rechtermuisknop op de stap die u wilt kopiëren of klik op pictogram met drie stippen ernaast.
- Selecteer in het vervolgkeuzemenu een van de opties Kopiëren als....
U kunt stappen in verschillende formaten kopiëren: JSON, Puppeteer , @puppeteer/replay en die van extensions .
Stappen verwijderen
Om een per ongeluk opgenomen stap te verwijderen, klikt u met de rechtermuisknop op de stap of klikt u op de pictogram met drie stippen ernaast en selecteer Stap verwijderen .
Bovendien voegt de Recorder automatisch twee afzonderlijke stappen toe aan het begin van elke opname:
- Kijkvenster instellen . Hiermee kunt u de afmetingen, schaling en andere eigenschappen van het venster beheren.
- Navigeren . Stelt de URL in en vernieuwt de pagina automatisch bij elke herhaling.
Als u automatisering op de pagina wilt uitvoeren zonder de pagina opnieuw te laden, verwijdert u de navigatiestap zoals hierboven beschreven.
Configureer stappen
Een stap configureren:
Geef het type op:
click
,doubleClick
,hover
, (input)change
,keyUp
,keyDown
,scroll
,close
,navigate
(naar een pagina),waitForElement
,waitForExpression
ofsetViewport
.Andere eigenschappen zijn afhankelijk van de
type
.Geef de vereiste eigenschappen op onder het
type
.Klik op de overeenkomstige knoppen om optionele typespecifieke eigenschappen toe te voegen en deze op te geven.
Zie Stapeigenschappen voor een lijst met beschikbare eigenschappen.
Om een optionele eigenschap te verwijderen, klikt u op de Knop ernaast verwijderen .
Om een element toe te voegen aan of te verwijderen uit een array-eigenschap, klikt u op de knoppen + of - naast het element.
Stap eigenschappen
Elke stap kan de volgende optionele eigenschappen hebben:
-
target
—een URL voor het Chrome DevTools Protocol (CDP) -doel, het standaardmain
verwijst naar de huidige pagina. -
assertedEvents
die slechts éénnavigation
kunnen zijn.
Andere veel voorkomende eigenschappen die beschikbaar zijn voor de meeste staptypen zijn:
-
frame
—een array van op nul gebaseerde indexen die een iframe identificeren dat kan worden genest. U kunt bijvoorbeeld het eerste (0) iframe binnen een tweede (1) iframe van het hoofddoel identificeren als[1, 0]
. -
timeout
—een aantal milliseconden dat moet worden gewacht voordat een stap wordt uitgevoerd. Zie Time-outs voor stappen aanpassen voor meer informatie. -
selectors
—een reeks selectors. Zie Selectoren begrijpen voor meer informatie.
Typespecifieke eigenschappen zijn:
Type | Eigendom | Vereist | Beschrijving |
click doubleClick | offsetX offsetY | Ten opzichte van de linkerbovenhoek van het inhoudsvak van het element, in pixels | |
click doubleClick | button | Aanwijzerknop: primair | hulp | tweede | terug | vooruit | |
change | value | Eindwaarde | |
keyDown keyUp | key | Sleutelnaam | |
scroll | x y | Absolute scroll-x- en y-posities in pixels, standaard 0 | |
navigate | url | Doel-URL | |
waitForElement | operator | >= | == (standaard) | <= | |
waitForElement | count | Aantal elementen geïdentificeerd door een selector | |
waitForElement | attributes | HTML-kenmerk en de waarde ervan | |
waitForElement | properties | JavaScript-eigenschap en de waarde ervan in JSON | |
waitForElement | visible | Booleaans. Waar als het element zich in de DOM bevindt en zichtbaar is (heeft geen display: none of visibility: hidden ) | |
waitForElement waitForExpression | asserted events | type: navigation , maar u kunt de titel en URL opgeven | |
waitForElement waitForExpression | timeout | Maximale wachttijd in milliseconden | |
waitForExpression | expression | JavaScript-expressie die wordt omgezet in true | |
setViewport | width height | Breedte en hoogte van de viewport in pixels | |
setViewport | deviceScaleFactor | Vergelijkbaar met Device Pixel Ratio (DPR), standaard 1 | |
setViewport | isMobile hasTouch isLandscape | Booleaanse vlaggen die specificeren of: |
Er zijn twee eigenschappen die ervoor zorgen dat het afspelen wordt gepauzeerd:
De eigenschap
waitForElement
zorgt ervoor dat de stap wacht op de aanwezigheid (of afwezigheid) van een aantal elementen die door een selector worden geïdentificeerd. De volgende stap wacht bijvoorbeeld tot er minder dan drie elementen op de pagina staan die overeenkomen met de selector.my-class
."type": "waitForElement", "selectors": [".my-class"], "operator": "<=", "count": 2,
De eigenschap
waitForExpression
zorgt ervoor dat de stap wacht totdat een JavaScript-expressie is omgezet naar waar. De volgende stap pauzeert bijvoorbeeld twee seconden en wordt vervolgens omgezet in waar, zodat het opnieuw afspelen kan worden voortgezet."type": "waitForExpression", "expression": "new Promise(resolve => setTimeout(() => resolve(true), 2000))",
Pas de time-outs voor stappen aan
Als uw pagina trage netwerkverzoeken of lange animaties bevat, kan het opnieuw afspelen mislukken bij stappen die de standaardtime-out van 5000
milliseconden overschrijden.
Om dit probleem te voorkomen, kunt u de standaardtime-out voor elke stap in één keer aanpassen of afzonderlijke time-outs voor specifieke stappen instellen. Time-outs bij specifieke stappen overschrijven de standaardwaarde.
Om de standaardtime-out voor elke stap in één keer aan te passen:
Klik op Instellingen voor opnieuw afspelen om het vak Time-out bewerkbaar te maken.
Stel in het vak Time-out de time-outwaarde in milliseconden in.
Klik Speel het opnieuw af om de aangepaste standaardtime-out in actie te zien.
De standaardtime-out voor een specifieke stap overschrijven:
Vouw de stap uit en klik op Time-out toevoegen .
Klik op de
timeout: <value>
en stel de waarde in milliseconden in.Klik Speel opnieuw om de stap met de time-out in actie te zien.
Als u een time-outoverschrijving voor een stap wilt verwijderen, klikt u op Verwijderen knop ernaast.
Begrijp selectors
Wanneer u een nieuwe opname start, kunt u het volgende configureren:
- Voer in het tekstvak Selectorattribuut een aangepast testattribuut in. De Recorder gebruikt dit attribuut om selectors te detecteren in plaats van een lijst met algemene testattributen .
In de selectievakjes Selectortypen om op te nemen kiest u de typen selectors die u automatisch wilt detecteren:
- CSS . Syntactische selectoren.
- ARIA . Semantische selectoren.
- Tekst . Selectors met de kortste unieke tekst, indien beschikbaar.
- XPath . Selectors die XML Path Language gebruiken.
- Doorboren . Selectors lijken op de CSS-selecties, maar kunnen schaduw-DOM doorbreken .
Gemeenschappelijke testselectors
Voor eenvoudige webpagina's zijn id
-attributen en CSS- class
-attributen voldoende om de Recorder de selectors te laten detecteren. Dat is echter niet altijd het geval omdat:
- Uw webpagina's kunnen dynamische klassen of ID's gebruiken die veranderen.
- Uw selectors kunnen defect raken vanwege wijzigingen in de code of het raamwerk.
De CSS- class
kunnen bijvoorbeeld automatisch worden gegenereerd voor toepassingen die zijn ontwikkeld met moderne JavaScript-frameworks (bijvoorbeeld React , Angular , Vue ) en CSS-frameworks.
In deze gevallen kunt u data-*
attributen gebruiken om veerkrachtiger tests te maken. Er zijn al enkele algemene data-*
selectors die ontwikkelaars gebruiken voor automatisering. De Recorder ondersteunt hen ook.
Als u de volgende algemene testkiezers op uw website hebt gedefinieerd, detecteert en gebruikt de Recorder deze automatisch eerst:
-
data-testid
-
data-test
-
data-qa
-
data-cy
-
data-test-id
-
data-qa-id
-
data-testing
Inspecteer bijvoorbeeld het element "Cappuccino" op deze demopagina en bekijk de testattributen:
Neem een klik op "Cappuccino" op, vouw de overeenkomstige stap in de opname uit en controleer de gedetecteerde selectors:
Pas de selector van de opname aan
U kunt de selector van een opname aanpassen als de algemene testselectors niet voor u werken.
Deze demopagina gebruikt bijvoorbeeld het data-automate
attribuut als selector. Start een nieuwe opname en voer data-automate
in als selectorattribuut.
Vul een e-mailadres in en let op de selectorwaarde ( [data-automate=email-address]
).
Selectieprioriteit
De Recorder zoekt naar selectors in de volgende volgorde, afhankelijk van of u een aangepast CSS- selectorkenmerk hebt opgegeven:
- Indien gespecificeerd:
- CSS-kiezer met uw aangepaste CSS-kenmerk.
- XPath-kiezers.
- ARIA-selector indien gevonden.
- Een selector met de kortste unieke tekst, indien gevonden.
- Indien niet gespecificeerd:
- ARIA-selector indien gevonden.
- CSS-kiezers met de volgende prioriteit:
- De meest voorkomende attributen die worden gebruikt voor het testen:
-
data-testid
-
data-test
-
data-qa
-
data-cy
-
data-test-id
-
data-qa-id
-
data-testing
-
- ID-kenmerken, bijvoorbeeld
<div id="some_ID">
. - Reguliere CSS-kiezers.
- De meest voorkomende attributen die worden gebruikt voor het testen:
- XPath-kiezers.
- Pierce-kiezers.
- Een selector met de kortste unieke tekst, indien gevonden.
Er kunnen meerdere reguliere CSS-, XPath- en Pierce-selectors zijn. De recorder registreert:
- Reguliere CSS- en XPath-selectors op elk rootniveau, dat wil zeggen, eventuele geneste schaduwhosts .
- Prik selectors aan die uniek zijn onder alle elementen binnen alle schaduwwortels.