Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt

Use this file to discover all available pages before exploring further.

Use device.setVirtualSceneImage() and device.playAutomation() to place a barcode or QR code image in the emulator’s virtual camera scene and animate the camera toward it — simulating a real scan without a physical device. See the Android Device Reference for the full API. The sequence is: store the barcode image in team storage → place it on the virtual scene (table or wall) → play the Walk_to_image_room macro to animate the camera toward it → wait for your app to detect and process the scan.
Store your barcode image in team storage and reference it via process.env.TEAM_STORAGE_DIR. See Upload files for instructions. The image must encode the exact value your test expects.

​
Examples

Scan a barcode on the virtual table 
await device.setVirtualSceneImage({
  image: `${process.env.TEAM_STORAGE_DIR}/barcode.jpg`,
  location: "table",
});

await device.playAutomation({
  macro: "Walk_to_image_room",
});
Scan a barcode on the virtual wall 
await device.setVirtualSceneImage({
  image: `${process.env.TEAM_STORAGE_DIR}/barcode.jpg`,
  location: "wall",
});

await device.playAutomation({
  macro: "Walk_to_image_room",
});

​
When to use

  • Your app has a barcode or QR code scanner and you need to test it without physical hardware.
  • Your app uses QR codes to initiate a session, link an account, or navigate to a URL.
  • Your app reads barcodes as part of a checkout, inventory, or verification flow.
  • Your test needs to assert on a specific scanned value.

​
Full sample test

import { device, flow } from "@qawolf/flows/android";

const barcodeImagePath = `${process.env.TEAM_STORAGE_DIR}/barcode.jpg`;

export default flow(
  "Scan barcode",
  { target: "Android - Pixel", launch: true },
  async ({ driver, test }) => {
    await test("scan barcode and verify value", async () => {
      // Arrange
      await driver.$(`//*[@text='Scan']`).click();

      // Act
      await device.setVirtualSceneImage({
        image: barcodeImagePath,
        location: "table",
      });

      await device.playAutomation({
        macro: "Walk_to_image_room",
      });

      await driver
        .$(`//*[@text='Barcode Captured']`)
        .waitForDisplayed({ timeout: 10_000 });

      // Assert
      const value = await driver
        .$(`//android.widget.TextView[@resource-id='com.example.app:id/scanned_value']`)
        .getAttribute("text");

      if (value !== "1234567890128") {
        throw new Error(`Unexpected scan value: ${value}`);
      }
    });
  },
);
Last modified on May 20, 2026