Test salvati

Un flusso che un agente ha testato può essere conservato come test salvato: uno script più alcuni dettagli (nome, ticket, ambiente, credenziali usate, modalità di registrazione). Qualsiasi agente può riprodurlo, tu puoi guardarlo e la CI può eseguirlo.

Dove vivono i test

• I test di progetto sono salvati in .astral/tests/<id>.astral.js all’interno del tuo progetto e versionati con il tuo repository. L’id è uno slug del nome del test.
• I test temporanei sono conservati nella cartella dei dati di Astral e scadono dopo un certo numero di giorni (7 per impostazione predefinita).

L’agente ne salva uno con test_save e può collegarlo a un ticket. Un test salvato riproduce lo script, non il modello, quindi una riproduzione non consuma token del modello ed esegue gli stessi passaggi ogni volta.

return await astral.test('Login', async () => {
  await astral.step('Open the login page', () => astral.navigate({url: astral.url('/login')}));
  await astral.step('Sign in', async () => {
    await astral.fill({locator: {role: 'textbox', name: 'Email'}, credential: 'shop.demo', field: 'username'});
    await astral.fill({locator: {role: 'textbox', name: 'Password', exact: true}, credential: 'shop.demo', field: 'password'});
    await astral.click({locator: {role: 'button', name: 'Sign in'}});
    await astral.expect.url('/account');
  });
}, {record: 'actions'});

.astral/config.json

Il file .astral/config.json del progetto dichiara gli ambienti su cui girano i tuoi test e le credenziali che possono usare, per nome. I test navigano con astral.url('/login'), così lo stesso test gira su locale, staging o produzione.

{
  "project": "shop",
  "envs": {
    "local":   { "baseUrl": "http://localhost:3000" },
    "staging": { "baseUrl": "https://staging.example.com" },
    "prod":    { "baseUrl": "https://www.example.com", "protected": true }
  },
  "defaultEnv": "local",
  "collections": {
    "smoke": { "name": "Smoke", "tests": ["login", "checkout"] }
  },
  "credentials": {
    "shop.demo": {
      "username": "[email protected]",
      "password": { "keychain": "shop.demo.password" }
    }
  }
}

Credenziali e portachiavi

Un segreto in config.json è un riferimento a dove si trova, mai il valore. Una password in chiaro nel file viene rifiutata. Un riferimento è uno di questi:

{ "keychain": "<id>" }
{ "env": "ASTRAL_TEST_<NAME>" }
{ "local": "<key>" }

• L’agente vede solo il nome della credenziale e il nome utente. astral.fill risolve il valore da sé e lo digita con vere pressioni di tasti; l’agente sa solo che è stato digitato e mascherato.
• Un segreto viene digitato solo in un campo sensibile (password, codice monouso, carta) sull’origin dell’ambiente stesso, così non può essere riletto né inviato a un altro sito. I report mostrano •••••• al suo posto.
• Un segreto del portachiavi viene memorizzato insieme agli origin degli ambienti in quel momento e digitato solo su quelli, anche se config.json viene modificato in seguito. Per i login sensibili, preferisci il portachiavi.

Ambienti protetti

In un ambiente contrassegnato protected (la produzione, per esempio) girano solo i test dichiarati readOnly, e solo dopo che una persona ha approvato in Astral quella esatta versione del test. Un agente può chiedere readOnly: true, ma è una richiesta, non un’approvazione: la approvi tu con Approve as read-only nel pannello Tests, l’approvazione è conservata fuori dal progetto e va persa se il test viene modificato. In una collezione, i test non approvati vengono saltati con il motivo.

Viewport

Un test o una collezione può girare su uno o più viewport, e Astral esegue ogni test su ciascuno.

Un viewport personalizzato ha una larghezza e un’altezza da 200 a 4096 px, e facoltativamente una densità di pixel, il touch, uno user agent e un nome. Dentro Astral il pannello della scheda viene ridimensionato al viewport per l’esecuzione e poi torna alla sua dimensione; densità di pixel, touch e user agent non vengono emulati lì, e l’esecuzione lo segnala. Il runner headless con Chrome li emula tutti.

Il controllo del layout

Il controllo del layout esamina la pagina così come viene renderizzata e segnala dei rilievi, ciascuno con una regola, una gravità, un selettore, un rettangolo, un messaggio e una correzione CSS suggerita.

Tre modi per usarlo:

• Lo strumento layout_check: l’agente trova un problema, corregge il CSS e ricontrolla.
• astral.expect.layout() come passaggio di un test.
• layoutCheck: true su un test o una collezione, per aggiungere un controllo alla fine di ogni esecuzione per viewport.

{
  "collections": {
    "rwd": { "name": "Responsive", "tests": ["home", "checkout"], "viewports": ["mobile", "tablet", "desktop"], "layoutCheck": true }
  },
  "layout": { "ignore": [".chat-widget", "#cookie-banner"] }
}

Con uno screenshot, la pagina viene catturata con ogni rilievo evidenziato. Su un motore che non calcola il layout delle pagine, il controllo viene segnalato come saltato, mai come superato.

Riproduzione con Play

L’agente chiama test_open_in_astral e Astral apre il suo pannello Tests con il test caricato e in pausa. Premi Play per guardarlo girare: rallentatore, pausa, passo passo e stop. Per impostazione predefinita l’agente non può avviarlo: Play è anche un controllo di sicurezza. Per demo e revisioni che gli hai chiesto di condurre, l’agente può avviarlo con play: true; richiede lo stesso permesso di test_run, funziona solo per test salvati in un progetto che hai consentito, e tu mantieni Pause, Step e Stop.