Ember SDK overview
The Ember integration has two parts:
configure()to wrap your Testem configvizzlyScreenshot()in test files
Install
npm install -D @vizzly-testing/cli @vizzly-testing/embernpx playwright-core install chromium firefox webkitSet up Testem
const { configure } = require('@vizzly-testing/ember');
module.exports = configure({ test_page: 'tests/index.html?hidepassed', launch_in_ci: ['Chrome'], launch_in_dev: ['Chrome'],});configure() replaces Chrome, Firefox, Safari, and WebKit launchers
with Playwright-backed Vizzly launchers. Lowercase names work too.
Custom launchers stay unchanged. Browsers run headless by default. Pass
{ headless: false } as the second argument to configure() for a visible browser.
If your Ember setup serves tests from dist, pass cwd: 'dist' in the Testem config.
Capture screenshots in tests
import { module, test } from 'qunit';import { visit } from '@ember/test-helpers';import { setupApplicationTest } from 'ember-qunit';import { vizzlyScreenshot } from '@vizzly-testing/ember/test-support';
module('Acceptance | Dashboard', function(hooks) { setupApplicationTest(hooks);
test('dashboard', async function() { await visit('/dashboard'); await vizzlyScreenshot('dashboard'); });});The helper waits for Ember to settle before capture.
Useful options
await vizzlyScreenshot('login-form', { width: 375, height: 667, selector: '[data-test-login-form]', properties: { viewport: 'mobile' },});Common options:
widthandheightselectorscope:app,container, orpage; defaults toappfullPagepropertiesthresholdminClusterSizefailOnDiffbuildIdrequestTimeout
failOnDiff uses the screenshot option first, then the environment or server
file setting. By default, a local diff doesn’t throw.
Each screenshot includes framework: 'ember', browser, and url metadata. Your properties override those defaults. Image dimensions come from the captured bitmap; the client doesn’t generate viewport properties.
Run it
For local review:
npx vizzly tdd startember testFor cloud builds:
npx vizzly run "ember test"Extra helper
If you need a guard, the package also exports isVizzlyAvailable().