Om åtgärden Kör JavaScript på webbsida i Genvägar

Om att hämta webbsidodata

Med åtgärden Kör JavaScript på webbsida kan du hämta data från en webbsida genom att hämta alla element som matchar vissa villkor och sedan iterera genom dessa element för att utföra en åtgärd (eller för att inspektera elementen ytterligare).

Om du till exempel vill skapa en lista över varje bildelement på en webbsida använder du:

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

Om du istället vill hämta varje element med klassen "post” använder du:

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

När en NodeList har skapats kan du iterera genom elementen (för att ytterligare filtrera elementen eller lägga till elementen i en datastruktur) med hjälp av något i stil med:

Mer information om hur du granskar webbsideresultat finns på https://developer.mozilla.org/Selectors och https://developer.mozilla.org/SelectorAll.

Inmatning till åtgärden Kör JavaScript på webbsida

Inmatningen till åtgärden Kör JavaScript på webbsida måste vara en aktiv Safari-webbsida. Det innebär att du måste köra genvägen från Åtgärdstilläggsgenvägen i delningsbladet (mer specifikt från Safari, SFSafariViewController eller ASWebAuthenticationSession).

När en genväg körs från delningsbladet överförs inmatningen från Safari-appen till den första åtgärden i genvägen.

Även om inmatningen till åtgärden Kör JavaScript på webbsida måste vara en Safari-webbsida, kan du lägga till ytterligare data i åtgärden genom att använda magiska variabler. Till exempel innehåller följande genväg en Kör JavaScript på webbsida-åtgärd som ändrar en video på en webbsida. Uppspelningshastigheten för videon styrs av hastighetsvariabeln.

Om åtgärden Kör JavaScript på webbsida inte är den första åtgärden i en genväg kommer ett felmeddelande visas när du kör genvägen.

För att korrigera detta kan du lägga till en Hämta variabel-åtgärd och ställa in dess parameter på Safari-webbsidan. Då överförs innehållet till åtgärden Kör JavaScript på webbsida.

Lär mer om hur du kör genvägar från Safari i Ställa in och köra genvägar från en annan app.

Utmatning från åtgärden Kör JavaScript på webbsida

För att kunna returnera data måste du ringa slutförandehanteraren i JavaScript, t.ex. slutförande(resultat). Eftersom JavaScript vanligtvis används med asynkrona mönster är samtalet avsiktligt inte synkront. På så sätt kan du avsluta åtgärden asynkront. Till exempel är följande giltigt:

Utmatningen från åtgärden Kör JavaScript på webbsida är samtliga giltiga JSON-datatyper, inklusive:

• Sträng

• Nummer

• Booleska (sant eller falskt)

• Matris (innehållande vilken annan giltig JSON-typ som helst)

• Ordlista (innehållande vilken annan giltig JSON-typ som helst)

• null

• odefinierat

Om du vill veta mer om JSON läser du Om att använda JSON i Genvägar.

Bakom kulisserna kodar och avkodar Genvägar automatiskt ditt returnerade värde för att kommunicera mellan JavaScript och appen Genvägar. Det betyder att du inte behöver ringa JSON.stringify(result) innan du ringer slutförandehanteraren.

Eftersom returneringsvärdet är JSON, kommer vissa returneringsvärden inte att fungera bra. Till exempel kommer en funktion eller nod inte att ha en användbar JSON-kodad representation. Om så är fallet rekommenderas du att skapa en Matris/Ordbok som innehåller de JSON-kompatibla värden du behöver.

Om du vill veta mer om noder läser du https://developer.mozilla.org/Node. Om du vill veta mer om funktioner läser du https://developer.mozilla.org/Functions.

Tidsgräns för åtgärden Kör JavaScript på webbsida

Liksom alla JavaScript-tillägg i Safari omfattas åtgärden Kör JavaScript på webbsida av en tidsgräns och ska slutföras så fort som möjligt. JavaScript som använder synkrona funktioner kan eventuellt inte slutföras i tid, till exempel:

• window.alert()

• window.prompt()

• window.confirm()

• Timeouts som varar i flera sekunder, till exempel: window.setTimeout(function() { completion(); }, 5000);

Om ditt JavaScript överskrider tidsgränsen kommer genvägen inte att slutföras och ett JavaScript Timeout-felmeddelande visas när du kör genvägen.

Hantering av syntax- och körtidsfel

Du kan använda alla syntaxer som stöds i Safari för att skriva JavaScript i åtgärden Kör JavaScript på webbsida. iOS 12 stöder ECMA 6 JavaScript-syntax, inklusive de för loopar och let-element.

I appen Genvägar hjälper åtgärden Kör JavaScript på webbsida dig att upptäcka fel genom att göra en grundläggande syntaxkontroll innan du kör genvägen från Safari-tillägget.

När du anger ditt skript i textfältet hjälper syntaxmarkeringen till att säkerställa att ditt JavaScript är giltigt. Om du till exempel glömmer att inkludera citattecken i slutet av en sträng markeras all text som följer den strängen.

Om ditt scripts syntax är giltigt men innehåller ett körtidsfel kommer åtgärden Kör JavaScript på webbsida att fånga och visa undantagen. Om ditt skript exempelvis refererar till en variabel eller åtgärd som inte existerar (till exempel shortcuts.completion()), visas ett felmeddelande vid körningen.

Integritet och säkerhet

När du tillåter en genväg att köra Javascript på en webbsida, kan den genvägen få tillgång till all information på webbsidan, inklusive potentiellt känsliga data. Appen Genvägar vidtar några åtgärder för att se till att du kör JavaScript-genvägar på ett säkert och privat sätt.

När du kör en genväg som innehåller åtgärden Kör JavaScript på webbsida visas en anvisning som informerar dig om att genvägen nu kommer att interagera med webbsidan. Det betyder att genvägen kan komma åt potentiellt känslig data från webbsidan, till exempel lösenord, telefonnummer eller kreditkortsinformation.

När du har tryckt på Tillåt körs genvägen på den angivna webbsidan. Om du kör samma genväg på samma webbsida igen, visar genvägar inte anvisningen igen. Denna behörighet fortsätter enligt en per-genväg-, per-webbsida-basis.

Efter att du har gett en genväg åtkomst till en webbsida, vidtar Genvägar en extra åtgärd för att ytterligare skydda dig mot potentiellt skadliga skript genom att regelbundet hämta uppdaterade skadliga malwaredefinitioner. Innan du interagerar med en webbsida analyserar Genvägar aktuellt JavaScript och konsulterar sedan malwaredefinitionerna. Baserat på denna utvärdering instrueras Genvägar att tillåta eller neka aktuellt script, alternativt visa en extra uppmaning innan genvägen får köras.

Om genvägen inte får köras visas ett förklarande felmeddelande.