În ce este DOM Selenium Structură și formă completă WebDriver?

⚡ Rezumat inteligent

Modelul de obiecte al documentului expune o pagină HTML la JavaScriptul ca un arbore de obiecte, permițând scripturilor și Selenium WebDriver citește, localizează și modifică orice element de pe pagină în timp ce browserul rulează.

  • 🔘 Formular complet: DOM este prescurtarea de la Document Object Model (Modelul de Obiecte al Documentului), o interfață standardizată de W3C pentru documente HTML și XML.
  • ☑️ Structura arborescentă: Fiecare etichetă devine un nod, astfel încât html, head, body, article și p formează o ierarhie părinte-copil.
  • ✅ Trei obiecte: Fereastra încadrează fila, Document marchează rădăcina arborelui, iar Element reprezintă fiecare etichetă individuală.
  • 🧪 Metode de bază: getElementById, querySelector și querySelectorAll preiau noduri; innerHTML citește și rescrie conținutul acestora.
  • 🛠️ Depanare: Instrumentele pentru dezvoltatorii de browsere expun arborele analizat, iar modificările făcute acolo rămân valabile doar până la reîncărcarea paginii.
  • 📊 Evenimente: Acțiuni precum clic și încărcarea mesajelor de difuzare pe care atributele onclick sau addEventListener le pot intercepta.

În ce este DOM Selenium Structura și forma completă a WebDriver

În ce este DOM Selenium WebDriver?

HOTĂRÂREA in Selenium WebDriver este o componentă esențială a dezvoltării web folosind HTML5 și JavaScenariul. Forma completă a DOM este Document Object Model. DOM nu este un concept informatic. Este un set simplu de interfețe standardizate între dezvoltatorii web pentru a accesa și manipula documente în HTML sau XML folosind JavaScenariul.

Aceste standarde îi ajută pe dezvoltatori să construiască o pagină web fără să-și facă griji cu privire la detaliile implementării. Unele dintre organizațiile implicate în standardizarea acestor interfețe sunt precum Mozilla, Apple, Microsoft, Google, Adobe etc. Cu toate acestea, W3C este cel care oficializează un standard și îl publică – vezi aici (https://dom.spec.whatwg.org/).

Secțiunile de mai jos acoperă structura documentului, obiectele expuse de DOM și cum să le inspectezi. Mozilla păstrează referința API curentă pe Pagini MDN Document Object Model.

Fiecare Selenium locatorul se rezolvă în funcție de același arbore, deci structura de mai jos este ceea ce findElement() căutări.

Înțelegerea structurii DOM

Va trebui să înțelegeți structura DOM dacă construiți orice site web care implică utilizarea de scripturi JavaScenariul. Înțelegerea DOM este și mai critică dacă efectuați una sau toate următoarele sarcini complicate pe site-ul dvs. -

  1. Developing conținut care se actualizează continuu fără a reîmprospăta întreaga pagină – cum ar fi prețul curent al tuturor acțiunilor din portofoliul utilizatorului
  2. Developing interacțiuni avansate cu utilizatorii, cum ar fi adăugarea sau modificarea dinamică a conținutului – cum ar fi posibilitatea de a adăuga mai multe acțiuni în portofoliu
  3. Developing conținut personalizabil de către utilizator – cum ar fi posibilitatea de a schimba aspectul astfel încât portofoliul de fonduri mutuale să apară înaintea portofoliului de acțiuni
  4. Developing conținut responsiv pe site-ul dvs. web, astfel încât acesta să se adapteze automat la diferite ecrane media, cum ar fi iPhone, desktop, tabletă etc.

O pagină HTML de bază

<!DOCTYPE html>
<meta charset="UTF-8">
<html>
         <head>
            <title>my page title</title>
          </head>
<body>
         <article>
                  <p>
                         my first article
                   </p>
         </article>
        <aside>side bar content</aside>
</body>
</html>

Cum arată DOM PARSER al unui browser?

html    >     head    >    title
    >    body    >    aside
            >    article    >    p

Cum accesezi elementul corpului?

<script>
    var body = window.document.body;
</script>

Cum spui „Bună lume”?

<script>
    var body = document.querySelector("body > article > p").innerHTML = "Hello World!";
			</script>

În cele din urmă, întregul fișier HTML va arăta ca

Operatii Deschise Windows Notepad și inserați următorul conținut în interiorul acestuia. Apoi salvați fișierul ca „MyFileNewFile.html” (asigurați-vă că numele fișierului dvs. se termină cu .html).

<!DOCTYPE html>
<meta charset="UTF-8">
<html>
<head>
<title>my page title</title>
</head>
<body>
<article><p>my first article</p></article>
<aside>side bar content</aside>
<script>

    var body = document.querySelector("body > article > p").innerHTML = "Hello World!";
			</script>
</body>
</html>

În cele din urmă, deschideți fișierul folosind oricare dintre browserele preferate și veți vedea „Hello World!”

Componentele DOM în Selenium

Mai jos sunt principalele componente ale DOM este Selenium WebDriver:

  • Fereastră
  • Document
  • Element

Fiecare componentă se află la un nivel diferit al arborelui, începând de la cel mai exterior.

Fereastră

Window este obiectul care conține obiectul document într-un DOM. Se așează deasupra tuturor.

Pentru a ajunge la un obiect fereastră dintr-un document dat

<script>
      var window = document.defaultView;
</script>

Într-un mediu cu file, fiecare filă are propriul obiect fereastră. Cu toate acestea, dacă cineva ar dori să prindă și să implementeze evenimente precum window.resizeTo și window.resizeBy, acestea se aplică întregii ferestre și nu numai filei.

Proprietățile obiectului fereastră în DOM

window.localStorage – oferă acces la stocarea locală a browserului. Stocarea locală poate fi utilizată pentru a stoca și a prelua date dintr-o sesiune.

<script>
    window.localStorage.setItem('name','xyz');
	var name = window.localStorage.getItem('name');
</script>

fereastră.deschizător - primește referința la obiectul fereastră care a deschis această fereastră (fie făcând clic pe un link, fie folosind metoda window.open)

Metode utile ale obiectului fereastră

window.alert() – afișează un dialog de alertă cu un mesaj.

<script>
		window.alert('say hello');
</script>

Există multe evenimente utile pe care obiectul fereastră le expune. Le vom discuta în secțiunea „Evenimente” din Subiecte avansate

Document

Documentul marchează începutul unui arbore DOM. Documentul este primul nod dintr-un DOM. Are mai multe metode și proprietăți, al căror domeniu de aplicare se aplică întregului document, cum ar fi URL, getElementById, querySelector etc.

Proprietăți ale obiectului document în DOM

Document.documentURI și Document.URL – Ambele returnează locația curentă a documentului. Dacă, totuși, documentul nu este de tip Document HTML.URL nu va funcționa.

Document.activeElement – Această metodă returnează elementul din DOM care este în focalizare. Aceasta înseamnă că, dacă un utilizator este...ping Într-o casetă de text, Document.activeElement va returna o referință la acea casetă de text.

Titlul documentului – Acesta este folosit pentru a citi sau a seta un titlu pentru un anumit document.

Metode utile ale obiectului document

Document.getElementById(ID șir) – aceasta este de departe cea mai relevantă și utilă metodă în manipularea DOM. Este utilizată pentru a căuta un element în arborele DOM folosind identificatorul său unicCăutarea ține cont de majuscule și minuscule, adică în exemplul următor „ „Elementul „nu poate fi căutat folosind cuvinte precum IntroDiv, introdiv sau iNtrodiv etc.”

<!DOCTYPE html>
<meta charset="UTF-8">
<html>
<head></head>
<body>
<div id='introDiv'></div>
<script>
		var label = Document.getElementById('introDiv');
		label.setInnerHTML('say hello again');
	</script>
</body>
</html>

Document.querySelectorAll(Selector de șiruri) – aceasta este o altă metodă utilizată pe scară largă pentru a selecta încă un element pe baza regulile selectorului CSS (dacă sunteți familiarizați cu notația $ din jQuery, aceasta folosește însăși această metodă). Nu vom aprofunda prea mult selectorii CSS. Selectorul CSS este un set de reguli prin care puteți obține o listă de elemente similare (pe baza regulii de selecție). Am mai folosit această metodă în secțiunea „Hello World”.

Element

Diagrama de mai jos arată cum se află un obiect Element în arborele DOM, sub nodul documentului.

Obiectul element afișat ca un nod în ierarhia arborelui DOM

Obiect element în DOM

Elementul este orice obiect reprezentat de un nod într-un arbore DOM al unui document. Ca întotdeauna, obiectul Element în sine este doar o contrafăcută.tract de proprietăți, metode și evenimente între un browser și un document HTML. Există tipuri speciale de elemente, cum ar fi HTMLElement, SVGElement, XULElement etc. Ne vom concentra doar pe HTMLElement în acest tutorial.

Proprietăți ale obiectului element în DOM

Element.id – Această proprietate poate fi utilizată pentru a seta sau a citi „ID” (un identificator unic) pentru un element HTML. ID-ul trebuie să fie unic printre elementele dintr-un arbore DOM. După cum am menționat anterior, ID-ul este folosit și de metoda Document.getElementById pentru a selecta un anumit obiect Element dintr-un arbore DOM.

HTMLElement.contentEditable – proprietatea contentEditable a unui element determină dacă conținutul acelui element este editabil/modificabil. Această proprietate poate fi setată așa cum se arată în scriptul de mai jos. Această proprietate poate fi folosită și pentru a determina dacă un anumit element este editabil sau nu. Încercați următorul script în interiorul oricărui corp HTML și veți observa că puteți edita orice conținut al corpului.

<script>
		document.body.contentEditable = true;
</script>

Element.innerHTML – innerHTML este o altă proprietate importantă pe care o folosim pentru a accesa conținut HTML din interiorul unui element. De asemenea, este folosit pentru a seta un nou conținut HTML al elementului. Este utilizat pe scară largă pentru a seta/modifica conținutul câmpurilor de date. Să spunem, de exemplu, că doriți ca pagina dvs. web să actualizeze temperatura orașului Mumbai în fiecare oră, puteți rula scriptul din exemplul următor la fiecare oră.

<!DOCTYPE html>
<meta charset="UTF-8">
<html>
<head>
<title>my page title</title>
</head>
<body>
<section>
<h1>Mumbai</h1>
<h2>Temperature</h2>
<span id='tempValue'></span><sup>o</sup>C
</section>
<script>
    document.getElementById('tempValue').innerHTML = '26';
			</script>
</body>
</html>

Metode utile ale obiectului element

HTMLElement.blur() & HTMLElement.focus() – metodele de estompare și de focalizare sunt utilizate pentru a elimina focalizarea sau, respectiv, a focaliza un element HTML. Aceste metode sunt cele mai utilizate pentru a muta focalizarea unui cursor între casetele de text dintr-o pagină web de introducere a datelor.

Element.querySelectorAll – Această metodă este similară cu metoda querySelector deja discutată pentru obiectul document. Această metodă va limita însă căutarea în cadrul descendenților elementului însuși.

Notă de precizie: Blocul de mai sus este reprodus așa cum a fost publicat. Codul funcțional folosește document cu un d minuscul și innerHTML proprietate, nu setInnerHTML().

Depanare în DOM

Instrumente pentru dezvoltatori ale Google Chrome, Mozilla Firefox, Internet Explorer (10 sau mai sus) sau Safari permit depanarea ușoară chiar în browser. Uneori, diferite browsere interpretează același marcaj HTML în mod diferit și atunci depanarea vă ajută să inspectați DOM-ul așa cum a fost interpretat de motorul DOM al browserului respectiv.

Notă pentru browser: Internet Explorer s-a retras în 2022, așa că DevTools-ul său este acum disponibil. Microsoft EdgePașii de mai jos sunt neschimbați; DevTools se deschide cu F12.

Acum, să presupunem că doriți să schimbați valoarea temperaturii de la 26oC la 32oC în ultimul exemplu. Vom face câțiva pași simpli pentru a face asta. Capturile de ecran afișate aici sunt de la Mozilla Firefox– totuși, pașii sunt aceiași în toate celelalte browsere.

  1. Deschideți MyFileNewFile.html (sau orice nume pe care l-ați dat fișierului HTML în tutorialele de mai sus) folosind browserul dvs.
  2. Folosiți mouse-ul și faceți clic dreapta pe valoarea temperaturii 26oC și faceți clic pe „Inspectați elementul”

    Faceți clic dreapta pe valoarea temperaturii și selectați Inspectați elementul în browser

  3. Observați că elementul în care ați ales să „Inspectați elementul” este afișat evidențiat în browser (fereastra de depanare apare de obicei în partea de jos a ecranului)

    Instrumente pentru dezvoltatorii de browser care evidențiază elementul span inspectat în arborele DOM

  4. Deschideți elementul făcând clic pe triunghiul înclinat de lângă el

    Extinderea elementului span în inspectorul DOM folosind comutatorul triunghi

  5. Selectați ceea ce doriți să editați și faceți dublu clic pe el. Veți primi o opțiune de a schimba textul. Faceți așa cum este indicat în imaginea animată de mai jos.

    Demonstrație animată a editării valorii textului DOM de la 26 la 32 în inspector

  6. Observați modificarea conținutului paginii dvs. HTML. Puteți închide fereastra de depanare acum.

    Rețineți că modificările dvs. vor fi menținute numai pentru această sesiune. De îndată ce reîncărcați sau reîmprospătați (apăsați F5) pagina, modificările vor fi revenite. Aceasta indică că nu ați schimbat sursa HTML reală, ci doar interpretarea locală a browserului dvs.

    Ca un exercițiu distractiv, încercați să faceți următoarele. Deschide www.facebook.com în browser și utilizați instrumentul de depanare pentru a urmări rezultatul - observați cum scrie „Am piratat Facebook”.

Rezultatul exercițiului arată ca în captura de ecran de mai jos.

Pagina de Facebook editată live în inspectorul browserului pentru a citi „Am spart Facebook-ul”

Citirea și editarea nodurilor acoperă pagini statice. Paginile interactive reacționează și la acțiunile utilizatorului.

Evenimente DOM

Ce sunt evenimentele în DOM?

Evenimentele sunt un model de programare în care incidentele declanșate de utilizator (sau declanșate de ciclul de viață al paginii de browser) sunt difuzate ca mesaje. De exemplu, când o pagină s-a terminat de încărcat, aceasta declanșează evenimentul window.load și, în mod similar, atunci când utilizatorul face clic pe un buton care evenimentul de clic al elementului este declanșat.

Aceste mesaje pot fi interceptate de orice JavaScenariu cod și apoi un acțiune definită de dezvoltator poate fi luat. Să presupunem, de exemplu, că doriți ca numerele de pe pagina dvs. web să se actualizeze doar atunci când utilizatorul face clic pe un buton. Puteți realiza acest lucru prin oricare dintre următoarele metode –

  1. Atribuiți o acțiune evenimentului onclick al elementului HTML
  2. Atribuiți o acțiune evenimentului clic folosind metoda addEventListener

Metoda 1

<!DOCTYPE html>
<html>
<head>
    <title>my page title</title>
</head>
<body>
    <section>
        <h1>Mumbai<h1>
        <h2>Temperature</h2>
        <span id='tempValue'></span><sup>o</sup>C
        <br/>
        <br/>
        <button onclick='onRefreshClick()'>Refresh</button>
    </section>
<script>
    	document.getElementById('tempValue').innerHTML = '26';

 function onRefreshClick(e) {
   document.getElementById('tempValue').innerHTML = '32';
}
			</script>
</body>
</html>

Metoda 2

<!DOCTYPE html>
<html>
<head>
    <title>my page title</title>
</head>
<body>
    <section>
        <h1>Mumbai<h1>
        <h2>Temperature</h2>
        <span id='tempValue'></span><sup>o</sup>C
        <br/>
        <br/>
        <button id='btnRefresh'>Refresh</button>
    </section>
<script>
    document.getElementById('tempValue').innerHTML = '26';
    document.getElementById('btnRefresh').addEventListener('click', function(event) {
    document.getElementById('tempValue').innerHTML = '32' },false);
			</script>
</body>
</html>

Depanare în DOM

Notă API-ul vechi: Două răspunsuri de mai jos folosesc document.write(). Rulează în continuare, dar un apel după încărcarea paginii șterge documentul. Se preferă console.log() sau innerHTML.

Î. Cum știu dacă un element există sau nu?

A. Încercați să căutați elementul folosind oricare dintre selector și verificați dacă elementul returnat este nul. Vezi exemplul de mai jos -

if(document.getElementById("elementIDWhichIsNotPresentInDOM") === null)
{
    //do something
}

Î. Primesc TypeError: document.getElementByID nu este o funcție...

A. Asigurați-vă că numele metodei se potrivește exact cu metoda API. Ca și în întrebarea de mai sus - este getElementById și nu getElementByID.

Î. Care este diferența dintre copii și childNodes?

A. Metoda copiii ne obțin colecția tuturor elementelor din elementul apelant. Colecția returnată este de tip HTMLCollection. Cu toate acestea, metoda childNodes ne aduce colecția tuturor nodurilor din elementul apelant. Adăugați următoarele scripturi la exemplul nostru și vedeți diferența -

Metoda childNodes returnează 14 elemente

document.write("Using childNodes method")
document.write("<br>");
document.write("<br>");
for(i=0;i<document.getElementsByTagName("section")[0].childNodes.length;i++)
{
    document.write((i+1)+".");
    document.write(document.getElementsByTagName("section")[0].childNodes[i].toString());
    document.write("<br>");
}
document.write("<br>");
document.write("Number of nodes in a section " + document.getElementsByTagName("section")[0].childNodes.length);

În timp ce metoda copiilor returnează doar 7 articole

document.write("Using children method")
document.write("<br>");
document.write("<br>");
for(i=0;i<document.getElementsByTagName("section")[0].children.length;i++)
{
    document.write((i+1)+".");
    document.write(document.getElementsByTagName("section")[0].children[i].toString());
    document.write("<br>");
}
document.write("<br>");
document.write("Number of nodes in a section " + document.getElementsByTagName("section")[0].children.length);

Î. Primesc o eroare de tip neprinsă: nu pot citi proprietatea „innerHTML” a undefined...

A. Asigurați-vă că instanța HTMLElement pe care apelați proprietatea innerHTML a fost setată după declararea inițială. Această eroare se întâmplă în general în scenariul următor. Vedeți cum poate fi evitată eroarea în următorul bloc de cod...

var element;
if(false) //say condition was false
{
    element = document.getElementById('tempValue1');
}
element.innerHTML = '32';
var element = null;
if(false) //say condition was false
{
    element = document.getElementById('tempValue1');
}
if(element != null)
{
    element.innerHTML = '32';
}

Întrebări frecvente

Shadow DOM este o funcționalitate a browserului care oferă unei componente propriul subarbore izolat, astfel încât stilurile și scripturile să nu fie afectate de scurgeri. Virtual DOM este o tehnică de bibliotecă, utilizată de React și Vue, care compară o copie în memorie pentru a minimiza actualizările reale.

WebDriver trimite un localizator către browser, care parcurge arborele analizat până când apare o potrivire, apoi returnează un handle WebElement. Localizatori Valori precum id, name, selectorul CSS și XPath descriu pur și simplu reguli de căutare diferite pe aceleași noduri.

Folosește getElementById când ținta are un ID unic; este cea mai rapidă căutare și returnează un nod. Folosește querySelector sau querySelectorAll când potrivirea depinde de clase, atribute sau o cale părinte-copil.

Se execută în continuare, dar browserele îl descurajează. Apelarea funcției document.write() după ce pagina s-a încărcat înlocuiește întregul document și blochează analiza în timpul încărcării. Folosește console.log() pentru tracing sau innerHTML pentru a insera conținut.

Conținutul paginii modelelor DOM: antetul, corpul și fiecare etichetă. Modelul de obiecte al browserului acoperă browserul din jur, inclusiv navigatorul, ecranul, locația și istoricul. Obiectul fereastră este locul unde se întâlnesc ambele.

Internet Explorer s-a retras în 2022, așa că instrumentele sale pentru dezvoltatori se află acum în interior Microsoft EdgeFluxul de lucru rămâne neschimbat: apăsați F12 sau faceți clic dreapta pe un element, alegeți Inspectare și editați nodul în panoul care se deschide.

Instrumentele de învățare automată evaluează simultan mai multe atribute de nod, astfel încât atunci când o clasă sau un ID se modifică, acestea repară același element în loc să eșueze. Platformele de testare cu auto-reparare construiesc acest lucru pe baza interogărilor DOM obișnuite.

Co-pilot elimină listenerele de evenimente, lanțurile querySelector și buclele de traversare dintr-un comentariu și este fiabil în ceea ce privește modelele comune. Testează întotdeauna sugestia pe pagina reală, deoarece nu poate vedea markup-ul tău.

Rezumați această postare cu: