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.
Video injection is only available for apps that QA Wolf resigns during installation. It is not available for system apps or Safari.
Example
Inject a video into the camera feed:
import { device } from "@qawolf/flows/ios";
const bundleId = process.env.BUNDLE_ID; // Bundle ID of app being tested
const storagePath = process.env.STORAGE_PATH; // QA Wolf remote storage
const videoPath = `${storagePath}/wolf.mp4`;
const cleanup = await device.injectCamera(driver, bundleId, {
data: videoPath,
type: "video", // optional — inferred from .mp4/.mov/.m4v/.avi
});
// ... run your assertions while the camera feed plays the video ...
await cleanup();
When to use
- Your app records video and you need to verify the recording pipeline with deterministic content.
- You need to run the same scenario repeatedly with consistent inputs.
Supported file types
Video: Any format supported by AVAsset — MP4, MOV, M4V with H.264/HEVC codecs
Full sample test
import { flow, device, expect } from "@qawolf/flows/ios";
export default flow(
"iOS Media - Camera Video Injection",
{
target: "iOS - iPhone 15 (iOS 26)",
launch: {
app: { env: "IPA_APP_BUILD" },
respectSystemAlerts: true,
autoAcceptAlerts: true,
},
},
async ({ driver, test }) => {
await test("iOS Media - Camera Video Injections", async () => {
//--------------------------------
// Arrange:
//--------------------------------
// Install and Launch Trot app
// Tap "Media"
await driver
.$(
`-ios predicate string:name == 'Media' AND type == 'XCUIElementTypeButton'`,
)
.waitForDisplayed();
await driver
.$(
`-ios predicate string:name == 'Media' AND type == 'XCUIElementTypeButton'`,
)
.click();
// Tap Video Recording
await driver
.$(
`-ios predicate string:name == 'Video Recording' AND type == 'XCUIElementTypeButton'`,
)
.waitForDisplayed();
await driver
.$(
`-ios predicate string:name == 'Video Recording' AND type == 'XCUIElementTypeButton'`,
)
.click();
// Tap AVCaptureMovieFileOutput
await driver
.$(
`-ios predicate string:name == 'AVCaptureMovieFileOutput' AND type == 'XCUIElementTypeButton'`,
)
.waitForDisplayed();
await driver
.$(
`-ios predicate string:name == 'AVCaptureMovieFileOutput' AND type == 'XCUIElementTypeButton'`,
)
.click();
// Observe "Start Recording" button
await driver
.$(
`-ios predicate string:name == 'unifiedRecordButton' AND type == 'XCUIElementTypeButton'`,
)
.waitForDisplayed({ timeout: 10000 });
//--------------------------------
// Act:
//--------------------------------
// Inject video as the camera feed
const storagePath = process.env.STORAGE_PATH
await device.injectCamera(driver, "com.qawolf.trot", {
data: `${storagePath}/wolf.mp4`,
type: "video",
});
await driver.pause(3000);
//--------------------------------
// Assert:
//--------------------------------
// Assert Screenshot of Image File Displaying in Live Preview
const previewElement = driver.$(
`-ios predicate string:name == 'livePreview' AND type == 'XCUIElementTypeOther'`,
);
await previewElement.waitForDisplayed({ timeout: 5000 });
await expect(driver)
.toHaveScreenshot(
previewElement,
"video_recording_video_preview",
{ maxMisMatchPercentage: 5 },
);
// Click start recording
await driver
.$(
`-ios predicate string:name == 'unifiedRecordButton' AND type == 'XCUIElementTypeButton'`,
)
.click();
await driver.pause(3000);
// Click stop recording
await driver
.$(
`-ios predicate string:name == 'unifiedRecordButton' AND type == 'XCUIElementTypeButton'`,
)
.click();
// Observe a recording
await driver
.$(
`-ios predicate string:name BEGINSWITH 'AVCaptureMovieFileOutput_' AND type == 'XCUIElementTypeStaticText'`,
)
.click();
});
},
);