Skip to main content

Browsers & devices (Ultrafast Grid)

Overview​

Define what to render by setting browser in config. Eyes snapshots your stories locally, then UFG renders across all browsers/devices in parallel—no grid to maintain.

Targets you can define​

Desktop browsers​

chrome, firefox, edgechromium, edgelegacy, ie10, ie11, safari.

You can reference relative versions like {browser}-one-version-back or {browser}-two-version-back for chrome, firefox, edgechromium, and safari.

See all of our supported Ultrafast Grid - Browsers and Devices

Multiple targets​

Provide an array:

module.exports = {
  browser: [
    { name: 'chrome', width: 1440, height: 900 },
    { name: 'firefox', width: 1024, height: 768 },
    { name: 'edgechromium-one-version-back', width: 1366, height: 768 },
  ],
};

Chrome device emulation​

See all of our supported Ultrafast Grid - Chrome emulation devices

Use a named device or custom metrics:

module.exports = {
  browser: {
    name: 'chrome',
    deviceName: 'Galaxy Note 8',
    screenOrientation: 'portrait',
  },
};
// or
module.exports = {
  browser: {
    name: 'chrome',
    width: 390,
    height: 844,
    deviceScaleFactor: 3,
    mobile: true,
  },
};

iOS devices​

See all of our supported Ultrafast Grid - iOS devices

Let UFG render on iOS:

module.exports = {
  browser: {
    iosDeviceInfo: {
      deviceName: 'iPhone 16',
      screenOrientation: 'portrait',
      iosVersion: 'latest',
    },
  },
};

IE compatibility (fake IE)​

Chrome masquerades as IE for compatibility checks:

module.exports = { browser: { fakeIE: true } };

Tips​

  • Start with 2–3 desktop widths + a phone. Expand as needed.
  • You can safely change coverage without touching test code; Eyes reuses baselines per target.