Skip to main content
Version: 0.17.0

annotate

production

Creates an annotated HTML file of the given image and saves it into the given path. If no image is given, then it captures the specified screen and annotates the captured image.

The annotated image is saved to <project_root>/report.

See also the detailed explanation.

Examples:

// The annoted image is saved to `<project_root>/report`.
await aui.annotate();

// or

UiControlClient.annotate({
imagePath: '<your-image-path>',
outputPath: '<path-of-the-generated-html>',
fileNamePrefix: '<prefix-of-the-output-file>',
customElements: CustomElementJson[], // A list of custom elements. The AI model will use them to detect elements similar to them.
elements: DetectedElement[] // A list of detected elements obtained with get()
});

Annotate DetectedElements from get()

The method also accepts an optional parameter of type AnnotationRequest. You can use this to annotate only the elements that where returned with a get().

Example:

const detectedElements = await aui.get().text().withText("User Interfaces?").exec();
await aui.annotate({ elements: detectedElements });

Resulting annotation from a screen displaying the website askui.com where only the text User Interfaces? has a bounding box:

Screenshot of askui.com website with a bounding box around the detected element User Interfaces?