Skip to main content

events

Base event class and utilities for GraphQL-Markdown events.

Events

abstract CancellableEvent

Defined in: events.ts:55

Base class for all cancellable events in GraphQL-Markdown.

Provides common functionality:

  • preventDefault() to cancel default actions
  • stopPropagation() to halt handler chain
  • Configurable cancellability
  • Optional default action function

Extended by

Implements

  • ICancellableEvent

Constructors

Constructor
new CancellableEvent(options?): CancellableEvent;

Defined in: events.ts:88

Creates a new CancellableEvent.

Parameters
options?

CancellableEventOptions

Configuration options for the event

Returns

CancellableEvent

Remarks

options.cancellable controls whether this event can be cancelled (default: true). options.defaultAction defines an optional function to execute as default action.

Accessors

defaultAction
Get Signature
get defaultAction(): DefaultAction | undefined;

Defined in: events.ts:110

Gets the default action function if one was provided.

Returns

DefaultAction | undefined

Implementation of
ICancellableEvent.defaultAction;
defaultPrevented
Get Signature
get defaultPrevented(): boolean;

Defined in: events.ts:96

Gets whether the default action has been prevented.

Returns

boolean

Set Signature
set defaultPrevented(value): void;

Defined in: events.ts:117

Allows setting defaultPrevented to true directly.

Parameters
value

boolean

Returns

void

Implementation of
ICancellableEvent.defaultPrevented;
propagationStopped
Get Signature
get propagationStopped(): boolean;

Defined in: events.ts:103

Gets whether propagation has been stopped.

Returns

boolean

Set Signature
set propagationStopped(value): void;

Defined in: events.ts:126

Allows setting propagationStopped to true directly.

Parameters
value

boolean

Returns

void

Implementation of
ICancellableEvent.propagationStopped;

Methods

preventDefault()
preventDefault(): void;

Defined in: events.ts:136

Prevents the default action from executing. Only works if the event is cancellable.

Returns

void

Implementation of
ICancellableEvent.preventDefault;
runDefaultAction()
runDefaultAction(): Promise<void>;

Defined in: events.ts:153

Executes the default action for an event if it hasn't been prevented.

Returns

Promise<void>

Implementation of
ICancellableEvent.runDefaultAction;
stopPropagation()
stopPropagation(): void;

Defined in: events.ts:146

Stops propagation to remaining event handlers. Handlers registered after the current one will not execute.

Returns

void

Implementation of
ICancellableEvent.stopPropagation;

abstract DataEvent

Defined in: events.ts:168

Abstract base for events that carry a typed, read-only data payload.

Extends

Extended by

Type Parameters

TData

TData

Type of the event data payload.

Constructors

Constructor
new DataEvent<TData>(data, options?): DataEvent<TData>;

Defined in: events.ts:172

Parameters
data

TData

options?

CancellableEventOptions

Returns

DataEvent<TData>

Overrides

CancellableEvent.constructor

Properties

data
readonly data: TData;

Defined in: events.ts:170

Read-only event data payload.

Accessors

defaultAction
Get Signature
get defaultAction(): DefaultAction | undefined;

Defined in: events.ts:110

Gets the default action function if one was provided.

Returns

DefaultAction | undefined

Inherited from

CancellableEvent.defaultAction

defaultPrevented
Get Signature
get defaultPrevented(): boolean;

Defined in: events.ts:96

Gets whether the default action has been prevented.

Returns

boolean

Set Signature
set defaultPrevented(value): void;

Defined in: events.ts:117

Allows setting defaultPrevented to true directly.

Parameters
value

boolean

Returns

void

Inherited from

CancellableEvent.defaultPrevented

propagationStopped
Get Signature
get propagationStopped(): boolean;

Defined in: events.ts:103

Gets whether propagation has been stopped.

Returns

boolean

Set Signature
set propagationStopped(value): void;

Defined in: events.ts:126

Allows setting propagationStopped to true directly.

Parameters
value

boolean

Returns

void

Inherited from

CancellableEvent.propagationStopped

Methods

preventDefault()
preventDefault(): void;

Defined in: events.ts:136

Prevents the default action from executing. Only works if the event is cancellable.

Returns

void

Inherited from

CancellableEvent.preventDefault

runDefaultAction()
runDefaultAction(): Promise<void>;

Defined in: events.ts:153

Executes the default action for an event if it hasn't been prevented.

Returns

Promise<void>

Inherited from

CancellableEvent.runDefaultAction

stopPropagation()
stopPropagation(): void;

Defined in: events.ts:146

Stops propagation to remaining event handlers. Handlers registered after the current one will not execute.

Returns

void

Inherited from

CancellableEvent.stopPropagation


abstract DataOutputEvent

Defined in: events.ts:186

Abstract base for events that carry typed data and a mutable output value.

Extends

Extended by

Type Parameters

TData

TData

Type of the event data payload.

TOutput

TOutput

Type of the mutable output value.

Constructors

Constructor
new DataOutputEvent<TData, TOutput>(
data,
initialOutput,
options?): DataOutputEvent<TData, TOutput>;

Defined in: events.ts:193

Parameters
data

TData

initialOutput

TOutput

options?

CancellableEventOptions

Returns

DataOutputEvent<TData, TOutput>

Overrides

DataEvent.constructor

Properties

data
readonly data: TData;

Defined in: events.ts:170

Read-only event data payload.

Inherited from

DataEvent.data

output
output: TOutput;

Defined in: events.ts:191

The generated output. Handlers can modify this property to change the final result.

Accessors

defaultAction
Get Signature
get defaultAction(): DefaultAction | undefined;

Defined in: events.ts:110

Gets the default action function if one was provided.

Returns

DefaultAction | undefined

Inherited from

DataEvent.defaultAction

defaultPrevented
Get Signature
get defaultPrevented(): boolean;

Defined in: events.ts:96

Gets whether the default action has been prevented.

Returns

boolean

Set Signature
set defaultPrevented(value): void;

Defined in: events.ts:117

Allows setting defaultPrevented to true directly.

Parameters
value

boolean

Returns

void

Inherited from

DataEvent.defaultPrevented

propagationStopped
Get Signature
get propagationStopped(): boolean;

Defined in: events.ts:103

Gets whether propagation has been stopped.

Returns

boolean

Set Signature
set propagationStopped(value): void;

Defined in: events.ts:126

Allows setting propagationStopped to true directly.

Parameters
value

boolean

Returns

void

Inherited from

DataEvent.propagationStopped

Methods

preventDefault()
preventDefault(): void;

Defined in: events.ts:136

Prevents the default action from executing. Only works if the event is cancellable.

Returns

void

Inherited from

DataEvent.preventDefault

runDefaultAction()
runDefaultAction(): Promise<void>;

Defined in: events.ts:153

Executes the default action for an event if it hasn't been prevented.

Returns

Promise<void>

Inherited from

DataEvent.runDefaultAction

stopPropagation()
stopPropagation(): void;

Defined in: events.ts:146

Stops propagation to remaining event handlers. Handlers registered after the current one will not execute.

Returns

void

Inherited from

DataEvent.stopPropagation

Other

CancellableEventOptions

Defined in: events.ts:39

Properties

cancellable?
optional cancellable?: boolean;

Defined in: events.ts:41

defaultAction?
optional defaultAction?: DefaultAction;

Defined in: events.ts:40


deepFreeze()

function deepFreeze<T>(obj): T;

Defined in: events.ts:23

Deep freezes an object to make it immutable at runtime. Recursively freezes all nested objects and arrays.

Type Parameters

T

T extends Record<PropertyKey, any>

Parameters

obj

T

The object to freeze

Returns

T

The frozen object (same reference)

Example

const data = { user: { name: "John" } };
deepFreeze(data);
data.user.name = "Jane"; // Throws error in strict mode