Een aangepaste toepassing testen en fouten hierin opsporen

Laatst bijgewerkt: 12 juli 2024

Gemaakt voor:

  • Ontwikkelaar

Eenheidstests voor een aangepaste toepassing uitvoeren

Installeer de Desktop van de Dokkerop uw machine. Als u een aangepaste worker wilt testen, voert u de volgende opdracht uit in de hoofdmap van de toepassing:

$ aio app test

Met deze opdracht wordt een testframework voor aangepaste eenheden voor Asset compute-toepassingsacties in het project uitgevoerd, zoals hieronder wordt beschreven. De component is gekoppeld aan een configuratie in het package.json -bestand. Het is ook mogelijk om JavaScript-eenheidstests zoals Jest te laten uitvoeren. De aio app test voert beide uit.

De {🔗 insteekmodule 0} air-cli-insteekmodule-asset-compute wordt ingebed als ontwikkelingsgebiedsdeel in douanetoepassing zodat het niet op bouwstijl/testsystemen moet worden geïnstalleerd.

Testframework voor toepassingseenheid

Met het testframework voor de Asset compute-toepassingseenheid kunt u toepassingen testen zonder code te schrijven. Het is afhankelijk van het principe van de bron naar het weergavebestand van toepassingen. Er moet een bepaalde bestands- en mapstructuur worden ingesteld om testcase te definiëren met bronbestanden voor tests, optionele parameters, verwachte uitvoeringen en aangepaste validatiescripts. Standaard worden de uitvoeringen vergeleken voor de gelijkheid van bytes. Bovendien kunnen externe HTTP-services eenvoudig worden gecontroleerd met behulp van eenvoudige JSON-bestanden.

Tests toevoegen

Tests worden verwacht in de map test op het hoofdniveau van het project. De testgevallen voor elke toepassing moeten zich in het pad test/asset-compute/<worker-name> bevinden, met één map voor elk testgeval:

action/
manifest.yml
package.json
...
test/
  asset-compute/
    <worker-name>/
        <testcase1>/
            file.jpg
            params.json
            rendition.png
        <testcase2>/
            file.jpg
            params.json
            rendition.gif
            validate
        <testcase3>/
            file.jpg
            params.json
            rendition.png
            mock-adobe.com.json
            mock-console.adobe.io.json

Heb een blik bij de toepassingen van de voorbeelddouanevoor sommige voorbeelden. Hieronder vindt u een gedetailleerde referentie.

Uitvoer testen

In de map build aan de basis van de Adobe Developer App Builder-app staan de gedetailleerde testresultaten en logboekbestanden van de aangepaste toepassing. Deze details worden ook weergegeven in de uitvoer van de opdracht aio app test .

Externe diensten koppelen

U kunt externe de dienstvraag binnen uw acties simuleren door mock-<HOST_NAME>.json dossiers voor uw testscenario's te creëren, met HOST_NAME die de specifieke gastheer is u van plan bent te animeren. Een geval van het voorbeeldgebruik is een toepassing die een afzonderlijke vraag aan S3 maakt. De nieuwe teststructuur ziet er als volgt uit:

test/
  asset-compute/
    <worker-name>/
      <testcase3>/
        file.jpg
        params.json
        rendition.png
        mock-<HOST_NAME1>.json
        mock-<HOST_NAME2>.json

Het mock-bestand is een http-reactie met JSON-indeling. Voor meer informatie, zie deze documentatie. Als er meerdere hostnamen zijn om te controleren, definieert u meerdere mock-<mocked-host>.json -bestanden. Hieronder ziet u een voorbeeldmodelbestand voor google.com genaamd mock-google.com.json :

[{
    "httpRequest": {
        "path": "/images/hello.txt"
        "method": "GET"
    },
    "httpResponse": {
        "statusCode": 200,
        "body": {
          "message": "hello world!"
        }
    }
}]

Het voorbeeld worker-animal-pictures bevat a mock dossiervoor de dienst Wikimedia die het met interactie aangaat.