appProcess.current.requestClose

API reference for the appProcess.current.requestClose method.

This version of the API is a preview. Preview APIs are unstable and may change without warning. You can't release public apps using this API until it's stable.

Requests the termination of the current process.

Once called, this method:

Transitions the state of the process to "closing".
Invokes all registered setOnDispose callbacks.
Waits for the process to finish closing.
Transitions the state of the process to "closed".

Each time the state changes, all of the registerOnStateChange callbacks are called.

Usage

Close current process

import { appProcess } from '@canva/platform';

await appProcess.current.requestClose({ reason: 'completed' });

TYPESCRIPT

Pass structured data to current process as it closes

import { appProcess, type CloseParams } from '@canva/platform';

type DetailedCloseParams = CloseParams & {
  metadata: {
    savePoint: string;
    timestamp: number;
    userInitiated: boolean;
  }
};

await appProcess.current.requestClose<DetailedCloseParams>({
  reason: 'completed',
  metadata: {
    savePoint: 'auto_backup_1',
    timestamp: Date.now(),
    userInitiated: true
  }
});

TYPESCRIPT

Parameters

paramsTRequired

Parameters to pass to the setOnDispose callback. Any structured data can be passed via this property.

reasonCloseReasonRequired

The reason the app process is closing.

Available values:

"completed"
"aborted"

Returns

Promise<void>