Despre acțiunea “Executați JavaScript pe pagina web” în Scurtături

Despre extragerea datelor de pe o pagină web

Acțiunea “Executați JavaScript pe pagina web” vă permite să extrageți date de pe o pagină web prin preluarea tuturor elementelor care corespund anumitor criterii, apoi iterarea acelor elemente pentru efectuarea unei sarcini cu datele respective (sau pentru inspectarea în continuare a elementelor).

De exemplu, pentru a crea o listă cu toate elementele imagine de pe o pagină web, utilizați:

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

Într-un alt exemplu, pentru a prelua fiecare element cu clasa “post”, utilizați:

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

După ce se creează un NodeList, puteți itera elementele (pentru a filtra în continuare elementele sau a adăuga elementele la o structură de date) utilizând ceva precum:

Pentru informații suplimentare despre interogarea rezultatelor paginii web, consultați https://developer.mozilla.org/Selectors și https://developer.mozilla.org/SelectorAll.

Intrarea acțiunii “Executați JavaScript pe pagina web”

Intrarea pentru acțiunea “Executați JavaScript pe pagina web” trebuie să fie o pagină web Safari activă, iar acest lucru înseamnă că trebuie să executați scurtătura din Extensie acțiune în Scurtături în foaia de partajare (mai exact, din Safari, SFSafariViewController sau ASWebAuthenticationSession).

Când o scurtătură este executată din foaia de partajare, intrarea din aplicația Safari este transmisă în prima acțiune a scurtăturii dvs.

Deși intrarea din acțiunea “Executați JavaScript pe pagina web” trebuie să fie o pagină web Safari, puteți insera date suplimentare în acțiune prin utilizarea Variabilelor magice. De exemplu, această scurtătură conține o acțiune “Executați JavaScript pe pagina web” care modifică un clip video de pe o pagină web. Rata de redare a clipului video este controlată de variabila Viteză.

Dacă acțiunea “Executare JavaScript pe pagina web” nu este prima acțiune din scurtătura dvs., va apărea un mesaj de eroare atunci când executați scurtătura.

Pentru a corecta această situație, puteți adăuga o acțiune “Obțineți o variabilă” și să configurați parametrii acesteia la pagina web Safari pentru a-i transfera conținutul în acțiunea “Executați JavaScript pe pagina web”.

Pentru informații despre executarea scurtăturilor din Safari, consultați Configurarea și executarea scurtăturilor din altă aplicație.

Ieșirea acțiunii “Executați JavaScript pe pagina web”

Pentru a returna date, trebuie să apelați gestionarul de finalizare în JavaScript, de exemplu, completion(result). Deoarece JavaScript este de obicei obișnuit cu tipare asincrone, apelul este intenționat nesincron. Astfel, puteți finaliza acțiunea asincron. De exemplu, următoarea comandă este validă:

Ieșirea acțiunii “Executați JavaScript pe pagina web” este orice tip de date JSON valid, inclusiv:

• Șir

• Număr

• Boolean (adevărat sau fals)

• Matrice (care conține orice alt tip JSON valid)

• Dicționar (care conține orice alt tip JSON valid)

• null

• nedefinit

Pentru informații suplimentare despre JSON, consultați Despre utilizarea JSON în Scurtături.

În culise, aplicația Scurtături codează și decodează automat valoarea dvs. returnată pentru a comunica între JavaScript și aplicația Scurtături. Acest lucru înseamnă că dvs. nu trebuie să apelați JSON.stringify(result) înainte de apelarea gestionarului de finalizare.

Deoarece valoarea returnată este JSON, anumite valori returnate nu vor funcționa bine. De exemplu, o funcție sau Nod nu va avea o reprezentare codată JSON utilă. În acest caz, vă recomandăm să creați o Matrice/Dicționar care conține valorile compatibile cu JSON de care aveți nevoie.

Pentru informații suplimentare despre Noduri, consultați https://developer.mozilla.org/Node; pentru informații suplimentare despre funcții, consultați https://developer.mozilla.org/Functions.

Limita de timp a acțiunii “Executare JavaScript pe pagina web”

Asemenea tuturor extensiilor JavaScript în Safari, acțiunea “Executare JavaScript pe pagina web” este supusă unei limite de timp și trebuie finalizată cât mai rapid posibil. Este posibil ca scripturile JavaScript care utilizează funcții sincronizate să nu se finalizeze la timp, inclusiv:

• window.alert()

• window.prompt()

• window.confirm()

• Timpii de expirare care durează mai multe secunde - de exemplu: window.setTimeout(function() { completion(); }, 5000);

Dacă scriptul JavaScript depășește limita de timp, scurtătura nu se va finaliza și va apărea un mesaj de eroare Expirare JavaScript atunci când executați scurtătura.

Manipularea erorilor de sintaxă și runtime

Puteți utiliza orice sintaxă compatibilă cu Safari pentru a scrie JavaScript în acțiunea “Executați JavaScript pe pagina web”. iOS 12 este compatibil cu sintaxa JavaScript ECMA 6, inclusiv bucle for of și let.

În aplicația Scurtături, acțiunea “Executare JavaScript pe pagina web” vă ajută să depistați erorile prin efectuarea unei verificări elementare a sintaxei înainte de a executa scurtătura din extensia Safari.

Pe măsură ce introduceți scriptul în câmpul de text, evidențierea sintaxei asigură validitatea JavaScript. De exemplu, dacă uitați să includeți ghilimele la capătul unui șir, este evidențiat tot textul ce urmează după respectivul șir.

Dacă sintaxa scriptului dvs. este validă, dar conține o eroare runtime, acțiunea “Executați JavaScript pe pagina web” surprinde și afișează excepțiile. De exemplu, dacă scriptul face referire la o variabilă sau o funcție care nu există (cum ar fi shortcuts.completion()), se afișează o eroare la momentul executării.

Intimitate și securitate

Când permiteți unei scurtături să execute Javascript pe o pagină web, respectiva scurtătură poate accesa toate informațiile de pe respectiva pagină, inclusiv date potențial sensibile. Aplicația Scurtături ia câteva măsuri pentru a se asigura că executați scurtăturile JavaScript în siguranță și confidențialitate.

Când executați o scurtătură care conține acțiunea “Executați JavaScript pe pagina web”, este afișat un avertisment care vă informează că scurtătura urmează să interacționeze cu pagina web. Aceasta înseamnă că scurtătura poate accesa date potențial sensibile de pe respectiva pagină, precum parole, numere de telefon sau informații despre cardul de credit.

După ce apăsați Permiteți, scurtătura se execută pe pagina web specificată. Dacă executați din nou aceeași scurtătură pe aceeași pagină web, aplicația Scurtături nu mai afișează solicitarea. Această permisiune rămâne valabilă pentru respectiva scurtătura și pentru pagina web respectivă.

După ce ați permis accesul unei scurtături la o pagină web, aplicația Scurtături face un pas suplimentar pentru a vă proteja de posibilele scripturi rău intenționate prin descărcarea periodică a definițiilor actualizate pentru malware. Înainte de a interacționa cu o pagină web, aplicația Scurtături analizează scriptul JavaScript, apoi consultă definițiile pentru malware. Pe baza acestei evaluări, aplicația Scurtături este instruită să permită scriptul, să respingă scriptul sau să afișeze un avertisment suplimentar înainte de a permite executarea scurtăturii.

Dacă se împiedică executarea scurtăturii, se afișează un mesaj de eroare explicativ.