> For the complete documentation index, see [llms.txt](https://guide-angular.wishtack.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide-angular.wishtack.io/angular/testing/end-to-end.md).

# End-to-End

## Pourquoi ?

Par définition, les tests unitaires ne testent pas les interactions entre les modules et certains effets de bord.

### Il est important de tester automatiquement l'ensemble de l'application.

> Il n'est pas envisageable de ne pas tester ou d'effectuer tous les tests manuellement à chaque changement ou encore d'en sélectionner uniquement une partie.

## Protractor

**Protractor est un framework de tests e2e développé par l'équipe d'AngularJS**. Il permet à la fois de tester les applications AngularJS et Angular mais aussi des sites web non-Angular.

Protractor utilise [**Jasmine**](/angular/testing/unit-testing/jasmine.md) **comme framework de tests** et d'assertion et le "webdriver" **Selenium pour communiquer avec les "browsers"**.

En plus de sa syntaxe simple, Protractor fournit des fonctionnalités supplémentaires spécifiques à Angular telles que l'"**Implicit Wait**" : il n'est pas nécessaire d'implémenter des temps d'attente ou des vérifications de présence d'éléments HTML. **Protractor attend l'arrêt de l'activité d'Angular pour évaluer l'étape suivante** du test.

## Ajout d'un test

Pour ajouter un test End-to-End, il suffit de créer un fichier `.e2e-spec.ts` dans le dossier `e2e` et d'utiliser [Jasmine](/angular/testing/unit-testing/jasmine.md) pour définir une suite de "specs".

{% tabs %}
{% tab title="signin.e2e-spec.ts" %}

```typescript
describe('signin', () => {

    const signinPage = new SigninPage();

    it('should show an error message if credentials are invalid', async () => {

        await signinPage.signIn({
            userName: 'ninja',
            password: 'isnohype'
        });

        const errorMessage = await signinPage.getErrorMessage();

        expect(errorMessage).toEqual('Invalid credentials 😱.');

    });

});
```

{% endtab %}
{% endtabs %}

## "Page Objects"

Une bonne pratique consiste à **factoriser les interactions avec une page** dans une classe dédiée *(Separation of Concerns)*. Ces classes sont des "**Page Objects**" prenant par convention l'extension `.po.ts`.

{% tabs %}
{% tab title="signin.po.ts" %}

```typescript
import { browser, by, element } from 'protractor';

export class SigninPage {

    navigateTo() {
        return browser.get('/signin');
    }

    getErrorMessage() {
        return element(by.css('[data-error-message]')).getText();
    }

    async signIn({userName, password}) {
        await element(by.css('[data-username]')).sendKeys(userName);
        await element(by.css('[data-password]')).sendKeys(password);
        await element(by.css('[data-submit-button]')).click();
    }

}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guide-angular.wishtack.io/angular/testing/end-to-end.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.