FAQ (Frequently Asked Questions)

È possibile utilizzare il runner locale dello script del browser sintetico per testare ed eseguire il debug dello script in locale.

Per creare test del browser, consultare gli esempi di script sintetici per browser disponibili all'indirizzo Instana.

Per ulteriori esempi, consultare i seguenti riferimenti:

• Script del browser

• Selenium testo laterale

• Script per più browser

Quando si crea un test del browser, è possibile impostare un valore di timeout per garantire che il test fallisca se l'esecuzione supera la durata specificata. Tuttavia, l'impostazione del timeout ha effetto solo se il valore è inferiore a BROWSERSCRIPT_TIMEOUT, il cui valore predefinito è 5 minuti.

Selenium I test registrati potrebbero non funzionare correttamente su Instana se nel browser sono presenti cookie e cronologia; inoltre, nei siti web potrebbero non essere visibili le finestre pop-up relative all'accettazione dei cookie. Per evitare questo problema, utilizza un'istanza locale di Instana Synthetic-browser-script per testare il tuo script in locale dopo averlo creato.

Con lo script per browser sintetico Instana è possibile eseguire le seguenti operazioni:

• Cancella automaticamente i profili utente: anche se riesci a eseguire correttamente gli script in locale con il plug-in IDE di Selenium, gli script potrebbero non funzionare su Instana a causa delle finestre pop-up. È necessario chiudere la finestra a comparsa prima di eseguire un'azione. Utilizzando il programma di esecuzione locale Synthetic - browser - script, i profili utente vengono automaticamente cancellati. Non è necessario cancellare manualmente i cookies dal browser.
• Prova le API di test estese per browser di Instana : se desideri utilizzare le API di test estese per browser di Instana, puoi avvalerti del runner locale Synthetic-browser-script per eseguire i test. Il runtime del local runner dello script del browser sintetico è lo stesso del motore del browser sintetico Instana.

Selenium IDE è uno strumento di registrazione open-source per generare localizzatori come selettori CSS, XPath, ID e così via. Selenium IDE aiuta a identificare gli elementi web. Tuttavia, presenta le seguenti limitazioni:

• È necessario un po' di lavoro manuale per aggiungere i comandi Explicit Wait, lo scorrimento, l'accesso al DOM Shadow e così via.
• I fallimenti dei test, come l'elemento non è collegato al documento della pagina, l'elemento non è interattivo, a volte non vengono segnalati. Selenium IDE è talvolta incompatibile con gli script runner, un problema noto.

Prova il tuo script in locale con il local runner di Synthetic-browser-script, fornito da Instana. Con questo strumento, è possibile vedere che l'interfaccia utente del browser completa richiede ed eseguire le azioni negli script di test per aiutare il debug e la risoluzione dei problemi. Se la logica di test è complessa, ad esempio se prevede l'uso di cicli, puoi anche provare a utilizzare i test con script browser sintetici di Instana, disponibili all'indirizzo JavaScript-based. Come aggiungere passi manuali per supportare lo Shadow DOM e così via, vedere le altre sezioni di questo argomento.

Il test potrebbe avere esito negativo con uno dei seguenti messaggi di errore:

• is not clickable at point (285,436) because another element <li> obscures it
• Failed to execute command clickElement {} element not interactable.

Per risolvere questo problema, spostare il mouse per concentrarsi sull'elemento. È possibile utilizzare uno dei seguenti metodi.

Potrebbe verificarsi l'errore StaleElementReferenceError: stale element reference: element is not attached to the page document. Si tratta di un errore comune di Selenium.

Questo errore si verifica quando lo script di test fa riferimento a un elemento web che non è più associato al DOM; ciò può accadere con pagine web che utilizzano framework come React o Vue. Per risolvere questo problema, vedere gli esempi.

Come verificare se il vostro caso di test ha avuto successo?

Nel campo di test del browser, utilizzare Asserzioni, Attesa esplicita per verificare i risultati del test. In questo modo è possibile garantire che la pagina web venga caricata e resa come previsto. Con il test del browser di Instana, puoi anche generare screenshot della tua sessione di test e controllare i log della console (comando Echo negli script registrati su Selenium ), i log del browser e il grafico della cronologia.

I seguenti comandi possono essere utili:

{
      "id": "938df959-9b65-4ae4-a2f5-59be6188ea5f",
      "comment": "This is how to sleep for 5 seconds.",
      "command": "pause",
      "target": "5000",
      "targets": [],
      "value": ""
},
{
    "id": "2d5c6b52-d2d7-4592-8052-87572a09e58b",
     "comment": "This is how to take screenshot",
     "command": "executeScript",
     "target": "await $browser.takeScreenshot()",
     "targets": [],
     "value": ""
}
 

Si possono anche provare i seguenti comandi di asserzione:

{
    "id": "46eb59c2-5fd6-4481-b3e8-eaaddab79a69",
    "comment": "This is one type of Assertions in browser testing",
    "command": "assertTitle",
    "target": "instana - Google Search",
    "targets": [],
    "value": ""
}
 

L'esempio seguente mostra come utilizzare Explicit Wait per verificare il test in uno script del browser:

await $browser.waitForAndFindElement($driver.By.xpath(`//h1[contains(text(), 'Websites & mobile apps')]`), 30000)
await $browser.wait($driver.until.titleContains(`Websites – Websites & mobile apps`), 30000);
 

Provate ad aggiungere i seguenti comandi nel vostro file laterale registrato:

{
      "id": "615cb3e5-fe2a-4859-b0aa-9df52f22028f",
      "comment": "This is Explicit Wait in browser testing",
      "command": "waitForElementPresent",
      "target": "id=mainmenu",
      "targets": [],
      "value": "30000"
},
{
      "id": "03e23d25-38e3-4051-81ff-740109350ee8",
      "comment": "This is how to add logging message in console logs",
      "command": "echo",
      "target": "Verify UI dashboard",
      "targets": [],
      "value": ""
}
 

Se il tuo sito web utilizza i frame, potresti riscontrare l'errore nessun elemento di questo tipo .

Per risolvere questo problema, passare al frame o iframe con $browser.switchTo().frame(id: number | WebElement);.

Per passare al frame o all'iframe per il test dello script del browser Instana :

let frameElement = await $browser.waitForAndFindElement($driver.By.xpath('//*[contains(@id, "pop-frame")]'), 10000);
await $browser.switchTo().frame(frameElement);
 

Per individuare gli elementi web, consultare la guida di riferimento disponibile all'indirizzo Selenium sulle strategie di localizzazione.

Il formato del selettore CSS è By.css(element[attribute='attribute-value']).

Il formato dell'espressione XPath è By.xpath("//element[@attribute='value']") o By.xpath("//*[@attribute='value']").

Per trovare un elemento per attributi, ad esempio <a href="mysite.com"></a>, eseguire:

// CSS selector
$driver.By.css(a[href*="example"] )
 

// XPath expression
$driver.By.xpath("//a[contains(@href,'Electronics')]")
$driver.By.xpath(`//dds-footer-nav-item[contains(.,'Developer education')]`)
 

Per modificare il localizzatore predefinito sul plug-in IDE Selenium , fare clic sulla destinazione.

È possibile selezionare un elemento da un elenco a discesa utilizzando il comando select. Con la proprietà Value, è possibile selezionare un valore da una serie di opzioni con label=, value=, id= o index=. Se non viene fornito alcun prefisso, viene utilizzata una corrispondenza con l'elemento label. Utilizzare label, value o id invece di index. In caso contrario, i risultati tra l'IDE di Instana e quello di Selenium potrebbero non essere compatibili.

L'esempio seguente mostra come selezionare giugno nell'elenco a discesa con il comando select. I metodi per selezionare l'opzione Giugno sono mostrati nelle righe 3, 4 e 5. Questi metodi funzionano su Selenium IDE e Instana.

<select id="month" name="month" class="inline six" onchange="document.cf.typ[1].checked=true">
  <option value="1">January</option>
  <option value="2">February</option>
  <option value="3">March</option>
  <option value="4">April</option>
  <option value="5">May</option>
  <option value="6">June</option>
  <option value="7">July</option>
  <option value="8" selected="">August</option>
  <option value="9">September</option>
  <option value="10">October</option>
  <option value="11">November</option>
  <option value="12">December</option>
</select>
 

L'attesa esplicita è una nota best practice dell' Selenium, volta a evitare gli no such element errori e a ridurre i tempi di attesa o di inattività. L'attesa esplicita è preferibile rispetto all'attesa implicita e a $browser.sleep.

Per utilizzare l'attesa esplicita nell' Instana, eseguire i comandi come illustrato negli esempi seguenti:

// wait until the title comes out
await $browser.wait($driver.until.titleContains('Year 2023 Calendar'), 10000);

// Call the wait function.
await $browser.wait(function () {
    return $browser.getTitle().then(function (title) {
      return title.includes("Google");
    });
  }, 10000);

await $browser.wait(async function () {
    const title = await $browser.getTitle();
    return title.includes("Google");
  }, 10000);

// waitForAndFindElement API
const cookies = await $browser.waitForAndFindElement(
    $driver.By.id(`truste-consent-button`),
    30000
);
await cookies.click();
 

Nello script Selenium IDE, si può usare il comando WAIT come mostrato nell'esempio seguente. Inserire il tempo di attesa in millisecondi per la proprietà value.

{
"id": "d13e50bd-f698-4a04-9420-701a21dcde8d",
"comment": "",
"command": "waitForElementPresent",
"target": "id=result-stats",
"targets": [
    ["id=result-stats", "id"],
    ["css=#result-stats", "css:finder"],
    ["xpath=//div[@id='result-stats']", "xpath:attributes"],
    ["xpath=//div[@id='slim_appbar']/div/div", "xpath:idRelative"],
    ["xpath=//div[7]/div/div/div/div/div", "xpath:position"]
],
"value": "10000"
}
 

Per richiamare le API estese di Instana, eseguire il runScript comando executeScript o utilizzando gli script dell'IDE di Selenium.

{
"id": "e781c454-0080-447a-b905-7183443956f3",
"comment": "",
"command": "runScript",
"target": "await $browser.takeScreenshot()",
"targets": [],
"value": ""
}
 

Gli elementi nell'elenco a discesa vengono selezionati con findElement e fanno clic.

<select id="month" name="month" >
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
...
</select>

// find element by css or xpath
await $browser.findElement($driver.By.css(`#month > option:nth-child(3)`)).click();
await $browser.findElement($driver.By.xpath(`//select[@id='month']/option[3]`)).click();

// wait until element located and do assertion
await $browser.wait($driver.until.elementLocated($driver.By.id("month")), 3000).click();
assert.equal(5, await $browser.findElement($driver.By.id("month")).getAttribute("value"));
await $browser.findElement($driver.By.xpath("//select[@id='month']/option[3]")).click();
assert.equal(3, await $browser.findElement($driver.By.id("month")).getAttribute("value"));
 

Per verificare gli elementi DOM shadow, utilizzare la funzione getShadowRoot() .

Per utilizzare la funzione getShadowRoot() , eseguire il seguente comando:

let shadowHost = await $browser.waitForAndFindElement(shadowHostSelector, timeout);
let shadowRoot = await shadowHost.getShadowRoot();
let element = await shadowRoot.findElement(elementSelector);
console.log("element text is:", await element.getText(), ", id is:", await element.getId());
 

Oppure utilizza le API avanzate di Instana negli script registrati nell'IDE di Selenium e usa il runner locale per testarli:

{
"id": "4f602785-2a19-4b5f-a23c-7ae6f6e58d5d",
"comment": "",
"command": "executeScript",
"target": "let shadowHost = await $browser.waitForAndFindElement($driver.By.css(`.field > q2-input`), 10000); let shadowRoot = await shadowHost.getShadowRoot(); let element = await shadowRoot.findElement($driver.By.css(`*[type='text']`)); await element.sendKeys(`user1`); ",
"targets": [],
"value": ""
},
 

Per verificare il testo sulla pagina con una corrispondenza parziale, è possibile utilizzare findElement per XPath.

Per i test di script SIDE BrowserScript e Selenium , è supportato 2FA (autenticazione a due fattori) per accedere ai siti Web.

Per lo script di test completo, consultare l'esempio all'indirizzo BrowserScript e l'esempio SIDE all'indirizzo Selenium.

Per verificare lo script o eseguire lo script in locale, sostituire le variabili url e $secure nel file synb.json con i valori effettivi.

Per passare 2FA, completa la seguente procedura:

1. Ottieni la chiave segreta TOTP (Time - based One - Time Password), un segreto condiviso generato in modo casuale tra te e il sito web per creare il token TOTP per l'accesso al sito web con autenticazione a due fattori (2FA). Questa chiave segreta viene generalmente fornita sotto forma di un codice QR o di un codice digitale durante la configurazione iniziale di 2FA. Per ottenere il codice digitale, fare clic su uno dei seguenti collegamenti della guida nella pagina di configurazione dell'autenticazione a due fattori:
   • Impossibile eseguire la scansione del codice QR
   • Problemi nella scansione? Immettere invece un codice.
2. Per proteggere la tua chiave segreta, crea delle credenziali sintetiche per la chiave segreta TOTP utilizzando l'interfaccia Instana. Apri API.
3. Nel test del browser, utilizza l' API a di test del $browser.generateTOTPToken(key: string) browser per generare un token TOTP a scadenza per i campi di immissione dati.
   • Per utilizzare BrowserScript per l'autenticazione 2FA :

     let totp_token = $browser.generateTOTPToken($secure.totpKey);
     await findElementByIdAndSendKeys("password", totp_token);
      

   • Per utilizzare lo script SIDE Selenium per l'autenticazione 2FA :

     {
        "id": "ec51296b-4d16-4167-ac83-ba87f89cc0c7",
        "comment": "Generate a TOTP token from a TOTP key",
        "command": "executeScript",
        "target": "return $browser.generateTOTPToken($secure.totpKey);",
        "targets": [],
        "value": "totpToken"
     }, {
        "id": "3cbc306a-ed33-46bf-9923-92752b0466f2",
        "comment": "",
        "command": "type",
        "target": "id=password",
        "targets": [],
        "value": "${totpToken}"
     },