Variable DefaultIframeAttributesConst

Default HTML attributes applied to every hidden iframe created by createHiddenFrame and used internally by runIframe.

These attributes control accessibility and identification of the iframe used during silent authentication and session-related operations.

Customization

This object is intentionally mutable and acts as a global extension point. Applications may modify or extend the attributes to adjust how the iframe is rendered—for example, to add monitoring hooks, test selectors, or custom accessibility attributes.

Modifications must be applied before any iframe-related OIDCClient methods are called (such as OIDCClient.silentLogin), because each iframe is created using a snapshot of DefaultIframeAttributes at creation time.

Example: Adding a custom attribute

import { DefaultIframeAttributes, OIDCClient } from "@plusauth/oidc-client-js";

// Add a custom data attribute to all future hidden iframes
DefaultIframeAttributes["data-myapp"] = "example";

const oidc = new OIDCClient({ ... });
await oidc.silentLogin();

// The silent login iframe now includes: <iframe data-myapp="example" ...>
Copy

Typical use cases include:

• Adding data-* attributes for debugging or testing
• Adding custom accessibility metadata
• Integrating with CSP / monitoring tools requiring tagged iframe elements