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.injectAudio() to replace your app’s microphone input with a pre-recorded audio file. This lets you test voice recording, speech recognition, and audio processing features under controlled, repeatable conditions.
See the iOS Device Reference for the full API.
Audio injection is only available for apps that QA Wolf resigns during installation. It is not available for system apps or Safari.
Examples
Inject audio into the microphone
const cleanup = await device.injectAudio(driver, process.env.BUNDLE_ID, {
data: `${process.env.TEAM_STORAGE_DIR}/sample_audio_input.wav`,
});
// trigger the microphone feature in your app
await cleanup();
const recordingAsBase64 = await driver.execute("mobile: pullFile", {
remotePath: `@${process.env.BUNDLE_ID}:/path/to/recording.m4a`,
});
const buffer = Buffer.from(recordingAsBase64, "base64");
const { writeFile } = await import("node:fs/promises");
await writeFile(`${process.env.TEAM_STORAGE_DIR}/recording.m4a`, buffer);
When to use
- Your app records audio or processes microphone input and you need to test that flow with known audio data.
- Your app has voice commands or speech recognition features that need consistent, repeatable input.
- Your app validates or transforms microphone input and you need to assert on the output.
- Your test needs to simulate a specific audio input that is difficult to produce in a test environment.
Supported file types
WAV
Full sample test
import { device, flow } from "@qawolf/flows/ios";
const audioPath = `${process.env.TEAM_STORAGE_DIR}/sample_audio_input.wav`;
export default flow(
"Test microphone input",
{
target: "iOS - iPhone 15 (iOS 26)",
launch: {
app: { env: "IPA_BUILD_LOCATION" },
respectSystemAlerts: true,
autoAcceptAlerts: true,
},
},
async ({ driver, test }) => {
await test("inject audio and verify recording was saved", async () => {
// Arrange
await driver.$(`//XCUIElementTypeButton[@name='Record Audio']`).click();
// Act
const cleanup = await device.injectAudio(driver, process.env.BUNDLE_ID, {
data: audioPath,
});
await driver.$(`//XCUIElementTypeButton[@name='Record']`).click();
await driver.pause(10_000);
await driver.$(`//XCUIElementTypeButton[@name='Done']`).click();
await cleanup();
// Assert
const recordingAsBase64 = await driver.execute("mobile: pullFile", {
remotePath: `@${process.env.BUNDLE_ID}:/path/to/recording.m4a`,
});
const buffer = Buffer.from(recordingAsBase64, "base64");
const { writeFile } = await import("node:fs/promises");
await writeFile(`${process.env.TEAM_STORAGE_DIR}/recording.m4a`, buffer);
expect(buffer.length).toBeGreaterThan(0);
});
},
);
