CrossOriginIsolationMiddleware

Definition

Assembly: CloudNimble.BlazorEssentials.Server.dll Namespace: CloudNimble.BlazorEssentials.Server.Middleware Inheritance: System.Object

Syntax

CloudNimble.BlazorEssentials.Server.Middleware.CrossOriginIsolationMiddleware

Summary

Middleware that adds Cross-Origin Isolation headers (COOP and COEP) to responses. These headers are required for features like SharedArrayBuffer and high-resolution timers, which are needed by WASM libraries like TursoDb that use OPFS (Origin Private File System).

Remarks

<strong>Warning:</strong> Enabling cross-origin isolation may break third-party scripts, iframes, and CDN resources that are not configured to work in an isolated context. Test thoroughly before enabling in production. Headers added:

Cross-Origin-Opener-Policy: same-origin - Isolates the browsing context
Cross-Origin-Embedder-Policy: require-corp - Requires all resources to explicitly grant permission

Examples

// In Program.cs
app.UseCrossOriginIsolation();

// Or with options
app.UseCrossOriginIsolation(options =&gt;
{
    options.CoopPolicy = "same-origin";
    options.CoepPolicy = "require-corp";
    options.ExcludePaths.Add("/api/");
});

Constructors

.ctor

Initializes a new instance of the CrossOriginIsolationMiddleware class.

Syntax

public CrossOriginIsolationMiddleware(Microsoft.AspNetCore.Http.RequestDelegate next, CloudNimble.BlazorEssentials.Server.Middleware.CrossOriginIsolationOptions options = null)

Parameters

Name	Type	Description
`next`	`Microsoft.AspNetCore.Http.RequestDelegate`	The next middleware in the pipeline.
`options`	`CloudNimble.BlazorEssentials.Server.Middleware.CrossOriginIsolationOptions?`	Configuration options for cross-origin isolation.

.ctor Inherited

Inherited from object

Syntax

public Object()

Methods

Equals Inherited Virtual

Inherited from object

Syntax

public virtual bool Equals(object obj)

Parameters

Name	Type	Description
`obj`	`object?`	-

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

public static bool Equals(object objA, object objB)

Parameters

Name	Type	Description
`objA`	`object?`	-
`objB`	`object?`	-

Returns

Type: bool

GetHashCode Inherited Virtual

Inherited from object

Syntax

public virtual int GetHashCode()

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

public System.Type GetType()

Returns

Type: System.Type

InvokeAsync

Invokes the middleware to add cross-origin isolation headers.

Syntax

public System.Threading.Tasks.Task InvokeAsync(Microsoft.AspNetCore.Http.HttpContext context)

Parameters

Name	Type	Description
`context`	`Microsoft.AspNetCore.Http.HttpContext`	The HTTP context.

Returns

Type: System.Threading.Tasks.Task A task representing the asynchronous operation.

MemberwiseClone Inherited

Inherited from object

Syntax

protected internal object MemberwiseClone()

Returns

Type: object

ReferenceEquals Inherited

Inherited from object

Syntax

public static bool ReferenceEquals(object objA, object objB)

Parameters

Name	Type	Description
`objA`	`object?`	-
`objB`	`object?`	-

Returns

Type: bool

ToString Inherited Virtual

Inherited from object

Syntax

public virtual string ToString()

Returns

Type: string?

​Definition

​Syntax

​Summary

​Remarks

​Examples

​Constructors

​ .ctor

​Syntax

​Parameters

​ .ctor Inherited

​Syntax

​Methods

​ Equals Inherited Virtual

​Syntax

​Parameters

​Returns

​ Equals Inherited

​Syntax

​Parameters

​Returns

​ GetHashCode Inherited Virtual

​Syntax

​Returns

​ GetType Inherited

​Syntax

​Returns

​ InvokeAsync

​Syntax

​Parameters

​Returns

​ MemberwiseClone Inherited

​Syntax

​Returns

​ ReferenceEquals Inherited

​Syntax

​Parameters

​Returns

​ ToString Inherited Virtual

​Syntax

​Returns

Definition

Syntax

Summary

Remarks

Examples

Constructors

.ctor

Syntax

Parameters

.ctor Inherited

Syntax

Methods

Equals Inherited Virtual

Syntax

Parameters

Returns

Equals Inherited

Syntax

Parameters

Returns

GetHashCode Inherited Virtual

Syntax

Returns

GetType Inherited

Syntax

Returns

InvokeAsync

Syntax

Parameters

Returns

MemberwiseClone Inherited

Syntax

Returns

ReferenceEquals Inherited

Syntax

Parameters

Returns

ToString Inherited Virtual

Syntax

Returns