> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Compatibility

> Nextedy RISKSHEET renders as a client-side JavaScript grid within Polarion LiveDoc pages. Browser support and behavior vary across platforms and browser engines.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## Supported Browsers

| Browser           | Engine         | Support Level                   | Notes                                            |
| ----------------- | -------------- | ------------------------------- | ------------------------------------------------ |
| Google Chrome     | Chromium/Blink | ✅ **Recommended**               | Primary development and testing target           |
| Microsoft Edge    | Chromium/Blink | ✅ **Recommended**               | Full compatibility with Chrome-equivalent engine |
| Mozilla Firefox   | Gecko          | **Supported with known issues** | Scrollbar interaction issue documented below     |
| Apple Safari      | WebKit         | ➖ See application               | Verify grid rendering in your specific version   |
| Internet Explorer | Trident        | ❌ **Not supported**             | Legacy engine lacks required JavaScript features |

<Tip title="Use Chrome or Edge">
  For the best experience with Risksheet, use the latest version of **Google Chrome** or **Microsoft Edge**. Both browsers use the Chromium engine and provide full compatibility with all Risksheet features, including grid rendering, formula calculation, export operations, and baseline comparison.
</Tip>

## Browser Requirements

Risksheet requires the following browser capabilities:

| Requirement        | Description                                      | Impact if Missing               |
| ------------------ | ------------------------------------------------ | ------------------------------- |
| JavaScript enabled | Client-side grid rendering and formula execution | Grid will not render            |
| ES6+ support       | Modern JavaScript syntax used in grid engine     | Script errors, grid failure     |
| CSS Grid/Flexbox   | Layout for grid cells, headers, and panels       | Broken layout                   |
| Clipboard API      | Copy/paste operations (`Ctrl+C`, `Ctrl+V`)       | Clipboard shortcuts unavailable |
| Session cookies    | Polarion authentication and session keepalive    | Session timeout, save failures  |
| Pop-up windows     | Configuration editor opens in new window         | Configuration editing blocked   |

## Known Issues

### Firefox Scrollbar Interaction

**Browser:** Mozilla Firefox (all versions)

**Symptom:** Clicking on Risksheet scrollbars causes the sheet to jump unexpectedly. The grid may scroll to an unintended position or select cells beneath the scrollbar area.

**Cause:** Firefox treats scrollbar areas as part of the page content area, which triggers cell selection events when clicking on the scrollbar. Chromium-based browsers (Chrome, Edge) correctly isolate scrollbar clicks from page content interactions.

**Workaround:** Use keyboard navigation (`Page Up`, `Page Down`, `Arrow` keys) for scrolling, or switch to Chrome or Edge as your primary browser.

**Priority:** Tracked as a low-priority known issue due to very low Firefox usage among Risksheet users.

<Warning title="Firefox Scrollbar Issue">
  If you experience unexpected grid jumping when clicking scrollbars in Firefox, this is a known browser-specific issue. The recommended solution is to use **Chrome** or **Edge** for Risksheet work. See [Keyboard Shortcuts](/risksheet/reference/keyboard-shortcuts) for navigation alternatives.
</Warning>

## Feature Support by Browser

The following table shows feature availability across supported browsers.

| Feature               | Chrome   | Edge     | Firefox        | Safari   |
| --------------------- | -------- | -------- | -------------- | -------- |
| Grid rendering        | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Cell editing          | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Formula calculation   | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Clipboard operations  | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| PDF export            | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Excel export          | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Baseline comparison   | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Scrollbar interaction | ✅ Normal | ✅ Normal | ⚠️ Known issue | ➖ Verify |
| Freeze pane           | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Context menu          | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Review columns        | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |
| Configuration editor  | ✅ Full   | ✅ Full   | ✅ Full         | ➖ Verify |

<Info title="Verify in application">
  Safari compatibility has not been comprehensively documented in the available source material. If your organization uses Safari, test all critical Risksheet features in your specific browser version before deploying to production users.
</Info>

## Baseline Comparison in Different Browsers

The baseline comparison feature adds the `comparingTo` URL parameter when entering comparison mode and removes it when exiting. This URL manipulation works in both standalone and iframe contexts across all supported browsers.

| Browser | URL State Management | Comparison Display | Tooltip Rendering |
| ------- | -------------------- | ------------------ | ----------------- |
| Chrome  | ✅ Full               | ✅ Full             | ✅ Full            |
| Edge    | ✅ Full               | ✅ Full             | ✅ Full            |
| Firefox | ✅ Full               | ✅ Full             | ✅ Full            |

Comparison mode features:

* **Ghost items**: Placeholder rows for removed items display correctly across all supported browsers
* **Change detection**: Added, removed, and modified indicators render consistently
* **Comparison tooltips**: Hover tooltips showing change details use the `comparison-tooltip` CSS class
* **Show/hide unchanged**: Toggle filtering works across all supported browsers

## Session Management and Keep-Alive

Risksheet includes an automatic session keep-alive mechanism that sends periodic heartbeat requests to prevent Polarion session timeout during long editing sessions. This feature relies on browser support for background HTTP requests.

| Browser | Keep-Alive Behavior | Notes                                                        |
| ------- | ------------------- | ------------------------------------------------------------ |
| Chrome  | ✅ Reliable          | Background tabs may throttle requests after extended periods |
| Edge    | ✅ Reliable          | Same Chromium behavior as Chrome                             |
| Firefox | ✅ Reliable          | Background tab throttling may apply                          |

<Tip title="Long Editing Sessions">
  If you experience session timeouts during extended risk analysis sessions, ensure your browser tab is not being aggressively throttled by the browser's power-saving features. Keeping the Risksheet tab in the foreground prevents throttling.
</Tip>

## Pop-up Window Requirements

The Risksheet configuration editor opens in a new browser window. Ensure your browser's pop-up blocker allows pop-ups from your Polarion server domain.

| Feature                  | Requires Pop-up | Description                                                               |
| ------------------------ | --------------- | ------------------------------------------------------------------------- |
| Configuration editor     | Yes             | Opens `risksheet/configuration/` URL with project and document parameters |
| Open Row Item            | Yes             | Opens work item in Polarion's standard editor                             |
| Open Linked Item         | Yes             | Opens linked work item in new window/tab                                  |
| Risksheet URL navigation | No              | In-page navigation via URL parameters                                     |

If the configuration editor fails to open, check your browser's pop-up settings and add the Polarion server URL to the allowed list.

## Rendering Performance Considerations

Risksheet grid performance depends on the browser's JavaScript engine and rendering capabilities. The following factors affect performance across browsers:

| Factor                  | Impact                                                      | Recommendation                                                                    |
| ----------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Number of visible rows  | High -- each row requires DOM rendering and cell formatting | Use level collapse and filtering to reduce visible rows                           |
| Number of columns       | High -- each column adds rendering overhead per row         | Use [Saved Views](/risksheet/reference/saved-views) to show only relevant columns |
| Cell decorators         | Medium -- JavaScript functions execute per cell render      | Optimize decorator functions; avoid complex logic                                 |
| Formula columns         | Medium -- formulas compute on each value change             | Keep formula expressions efficient                                                |
| Server-rendered columns | Low -- rendered once on load from server                    | Minimal browser impact after initial load                                         |
| Baseline comparison     | High -- doubles data volume and adds comparison overlay     | Limit comparison scope when possible                                              |

<Info title="Verify in application">
  Specific performance benchmarks for row/column counts vary by browser version, hardware, and Polarion server configuration. Test with representative data volumes on your target browser before setting performance expectations.
</Info>

## Browser Developer Tools for Debugging

When `debug` is enabled in your Risksheet configuration, diagnostic information is output to the browser developer console. Access the console in each browser:

| Browser | Open Developer Console                        | Shortcut                                   |
| ------- | --------------------------------------------- | ------------------------------------------ |
| Chrome  | Menu > More Tools > Developer Tools > Console | `F12` or `Ctrl+Shift+J`                    |
| Edge    | Menu > More Tools > Developer Tools > Console | `F12` or `Ctrl+Shift+J`                    |
| Firefox | Menu > Web Developer > Web Console            | `F12` or `Ctrl+Shift+K`                    |
| Safari  | Develop > Show Web Inspector > Console        | `Cmd+Option+C` (enable Develop menu first) |

Debug output includes ghost status, column ID, cell value, full item data, and comparison manager state. See [Keyboard Shortcuts](/risksheet/reference/keyboard-shortcuts) for details on the Debug context menu action.

## Recommended Browser Configuration

For optimal Risksheet experience:

| Setting               | Recommended Value                         | Reason                                                    |
| --------------------- | ----------------------------------------- | --------------------------------------------------------- |
| JavaScript            | Enabled                                   | Required for grid rendering                               |
| Cookies               | Allow session cookies for Polarion domain | Required for authentication                               |
| Pop-ups               | Allow for Polarion domain                 | Required for configuration editor                         |
| Zoom level            | 100%                                      | Prevents layout issues with frozen columns and cell sizes |
| Hardware acceleration | Enabled                                   | Improves grid rendering performance                       |
| Cache                 | Standard settings                         | Allows CSS and script caching for faster loads            |

## Related Pages

* [Keyboard Shortcuts](/risksheet/reference/keyboard-shortcuts) -- navigation alternatives when scrollbar issues occur
* [Polarion Version Compatibility](/risksheet/reference/compatibility/polarion-versions) -- server-side version requirements
* [Saved Views](/risksheet/reference/saved-views) -- reducing visible columns to improve browser performance
* [Configuration Properties Index](/risksheet/reference/configuration/properties-index) -- the `debug` configuration property
* [Troubleshooting](/risksheet/troubleshooting/index) -- resolving common browser-related issues

<LastReviewed date="2026-06-24" />
