Degraded mode alerts

The GBC alerts you when certain functions of your GBC version might not work properly due to limitations in your environment or configuration.

The degraded mode alert mechanism does not modify the internal behavior of the GBC but instead provides visual alerts and explanatory messages to notify you of potential issues. Alerts can be turned off by setting the theme variable theme-enable-degraded-mode-alerts to false in the theme configuration file. For more information, go to Disabling degraded mode alerts.

Conditions that trigger degraded mode

Degraded mode is activated in the following cases:
  • Unavailable APIs: Certain APIs required by GBC, such as the Clipboard API, are missing in the current environment. In most cases, this is due to the lack of secure context (external link) (HTTPS or localhost required).
  • Non-secure context: The application is not running in a secure context (HTTPS or localhost required).
  • Unsupported backend versions: The FGL or GAS versions being used are below the minimum required versions. Check the Genero compatibility for the GBC page for compatibility with your versions of FGL or GAS.

Alert mechanism

Alerts are visible in the following areas of the GBC application interface when degraded mode is detected:
  1. A red badge appears on the Settings icon in the chromebar. This badge prompts users to check the Settings for more details:
    Figure: Degraded mode alert settings icon badge

    Image shows a red badge in the settings icon when the GBC is operating in degraded mode
  2. Degraded mode details in the GBC Settings dialog:
    Figure: Degraded mode alert in Settings dialog

    Image shows a detailed message in the settings page when the GBC is operating in degraded mode
    The Settings page displays a detailed message when degraded mode is active. The message may contain one or more of the following, depending on the detected issues:
    • A list of unavailable APIs.
    • A message indicating that the backend versions (FGL/GAS) are not supported.
    • A message specifying that the application is not running in a secure context.
  3. Console message on startup:
    A message listing the causes for running in degraded mode is displayed in the browser console at application startup.
    Figure: Degraded mode alert in browser console on application startup

    Images shows degraded mode message alert in the browser console

Disabling degraded mode alerts

The degraded mode alert mechanism is enabled by default.

You can disable it by setting the theme variable theme-enable-degraded-mode-alerts to FALSE in the theme configuration file. For more information on the theme configuration file, go to theme.scss.json file.