Om handlingen Utfør JavaScript på nettside i Snarveier

Om henting av data fra nettsider

Med handlingen Utfør JavaScript på nettside kan du hente ut data fra en nettside ved å hente ut alle elementer som oppfyller visse kriterier, og repetere dette for alle aktuelle elementer, for å utføre en oppgave på dataene (eller undersøke elementene nærmere).

Du kan for eksempel opprette en liste med alle bildeelementene på en nettside ved å bruke:

var elements = document.querySelectorAll("img");

Hvis du vil hente alle elementer med klassen «post» kan du bruke:

var elements = document.querySelectorAll(".post");

Når det er opprettet en NodeList, kan du repetere gjennom elementene (for å avgrense filtreringen ytterligere eller legge til elementer i datastrukturen) ved å for eksempel bruke:

Du finner mer informasjon om spørringer for nettsideresultater på https://developer.mozilla.org/Selectors og https://developer.mozilla.org/SelectorAll.

Inndata for handlingen Utfør JavaScript på nettside

Inndata som sendes til handlingen Utfør JavaScript på nettside, må være en aktiv Safari-nettside. Det vil si at du må utføre snarveien fra Snarveier-handlingstillegget i delingsarket (fra Safari, SFSafariViewController eller ASWebAuthenticationSession).

Når en snarvei utføres fra delingsarket, sendes inndata fra Safari-appen til den første handlingen i snarveien.

Selv om inndata til Utfør JavaScript på nettside-handlingen må være en Safari-nettside, kan du sette inn ytterligere data i handlingen ved å bruke magiske variabler. Som et eksempel inneholder snarveien nedenfor en Utfør JavaScript på nettside-handling som endrer en video på en nettside. Avspillingshastigheten til videoen styres av Hastighet-variabelen.

Hvis Utfør JavaScript på nettside-handlingen ikke er den første handlingen i snarveien, vises det en feilmelding når du utfører snarveien.

Du kan korrigere dette ved å legge til en Hent variabel-handling og angi Safari-nettsiden som parameter for å sende innholdet til Utfør JavaScript på nettside-handlingen.

Hvis du vil vite mer om hvordan du utfører snarveier fra Safari, leser du Konfigurer og utfør snarveier fra en annen app.

Utdata for handlingen Utfør JavaScript på nettside

For å returnere data må du bruke completion-håndtereren i JavaScript, for eksempel completion(result). Kallet er ikke gjort synkront i og med at JavaScript vanligvis brukes med asynkrone mønstre. Dette gjør det mulig å fullføre handlingen asynkront. Her er et gyldig eksempel:

Utdata fra Utfør JavaScript på nettside er en hvilken som helst gyldig JSON-datatype, deriblant:

• Streng

• Tall

• Boolsk (sann eller usann)

• Oppstilling (som inneholder en annen gyldig JSON-type)

• Ordliste (som inneholder en annen gyldig JSON-type)

• null

• udefinert

Hvis du vil ha mer informasjon om JSON, leser du Om å bruke JSON i Snarveier.

Snarveier koder og dekoder automatisk den returnerte verdien i bakgrunnen for å kommunisere mellom JavaScript og Snarveier-appen. Det betyr at du ikke trenger å bruke JSON.stringify(result) før du bruker completion-håndtereren.

Siden returverdien er JSON, vil enkelte returverdier ikke fungere optimalt. En funksjon eller node har for eksempel ikke en brukbar JSON-kodet representasjon. I dette tilfellet anbefales det at du oppretter en oppstilling/ordbok som inneholder de JSON-kompatible verdiene du trenger.

Les mer om noder på https://developer.mozilla.org/Node og om funksjoner på https://developer.mozilla.org/Functions.

Tidsbegrensning for Utfør JavaScript på nettside-handlingen

I likhet med alle andre JavaScript-tillegg i Safari, gjelder en tidsbegrensning for Utfør JavaScript på nettside-handlingen. Den må derfor fullføres raskest mulig. Det kan forekomme at JavaScript-prosdyrer som bruker synkrone funksjoner ikke klarer å fullføre på tiden, blant annet disse:

• window.alert()

• window.prompt()

• window.confirm()

• Tidsavbrudd som varer i flere sekunder. Eksempel: window.setTimeout(function() { completion(); }, 5000);

Hvis JavaScript-prosedyren overskrider tidsbegrensningen, vil ikke snarveien bli fullført og du vil få opp en melding om JavaScript-tidsavbrudd når du utfører snarveien.

Håndtering av syntaks- og runtime-feil

Du kan bruke en hvilken som helst syntaks som det er støtte for i Safari når du skal skrive JavaScript i Utfør JavaScript på nettside-handlingen. iOS 12 støtter ECMA 6 JavaScript-syntaks, deriblant for of-sløyfer og let.

Handlingen Utfør JavaScript på nettside i Snarveier-appen hjelper deg med å finne feil ved å utføre en enkel syntakskontroll før du utfører snarveien fra Safari-tillegget.

Når du skriver inn prosedyren i tekstfeltet, hjelper syntaksformatering deg med å kontrollere at JavaScript-koden er gyldig. Hvis du for eksempel har glemt å ta med anførselstegn på slutten av en streng, framheves all teksten etter den strengen.

Hvis prosedyren har gyldig syntaks, men inneholder en runtime-feil, finner og viser Utfør JavaScript på nettside-handlingen unntakene. Hvis prosedyren for eksempel refererer til en variabel eller funksjon som ikke eksisterer (for eksempel shortcuts.completion()), vil det bli vist en feilmelding når prosedyren utføres.

Personvern og sikkerhet

Når du tillater at en snarvei kan utføre JavaScript på en nettside, vil snarveien ha tilgang til all informasjon som finnes på den nettsiden, inkludert potensielt sensitive opplysninger. Snarveier-appen er bygd opp slik at JavaScript-snarveiene dine utføres på en sikker og privat måte.

Når du utfører en snarvei som inneholder Utfør JavaScript på nettside-handlingen, vises en melding om at snarveien er i ferd med å utføre handlinger på nettsiden. Dette innebærer at snarveien kan få tilgang til potensielt sensitive data fra nettsiden, deriblant passord, telefonnumre og kredittkortinformasjon.

Når du trykker på Tillat, utføres snarveien på den spesifiserte nettsiden. Snarveier vil ikke spørre deg om dette igjen hvis du utfører den samme snarveien på den samme nettsiden igjen senere. Tillatelsen fortsetter å gjelde for den spesifikke snarveien og nettsiden.

Når du har gitt en snarvei tilgang til en nettside, utfører Snarveier et ekstra trinn for å beskytte deg mot potensielt skadelige prosedyrer ved å jevnlig laste ned oppdaterte skadevaredefinisjoner. Før du utfører handlinger med en nettside, analyserer Snarveier JavaScript-koden og sjekker deretter mot skadevaredefinisjonene. Basert på denne evalueringen instrueres Snarveier-appen om å tillate eller avvise prosedyren eller om det skal stilles et ekstra spørsmål før snarveien kan utføres.

Hvis snarveien forhindres i å utføres, vises en feilmelding som forklarer hvorfor.