feat: implements cold COM activation (#49919)

* fix: implements cold COM activation

* fix: code review feedack
This commit is contained in:
Jan Hannemann
2026-03-05 14:30:04 -08:00
committed by GitHub
parent d6fc627ba5
commit ddefb54c8f
8 changed files with 296 additions and 8 deletions

View File

@@ -36,6 +36,46 @@ The `Notification` class has the following static methods:
Returns `boolean` - Whether or not desktop notifications are supported on the current system
#### `Notification.handleActivation(callback)` _Windows_
* `callback` Function
* `details` [ActivationArguments](structures/activation-arguments.md) - Details about the notification activation.
Registers a callback to handle all notification activations. The callback is invoked whenever a
notification is clicked, replied to, or has an action button pressed - regardless of whether
the original `Notification` object is still in memory.
This method handles timing automatically:
* If an activation already occurred before calling this method, the callback is invoked immediately
with those details.
* For all subsequent activations, the callback is invoked when they occur.
The callback remains registered until replaced by another call to `handleActivation`.
This provides a centralized way to handle notification interactions that works in all scenarios:
* Cold start (app launched from notification click)
* Notifications persisted in AC that have no in-memory representation after app re-start
* Notification object was garbage collected
* Notification object is still in memory (callback is invoked in addition to instance events)
```js
const { Notification, app } = require('electron')
app.whenReady().then(() => {
// Register handler for all notification activations
Notification.handleActivation((details) => {
console.log('Notification activated:', details.type)
if (details.type === 'reply') {
console.log('User reply:', details.reply)
} else if (details.type === 'action') {
console.log('Action index:', details.actionIndex)
}
})
})
```
### `new Notification([options])`
* `options` Object (optional)

View File

@@ -0,0 +1,9 @@
# ActivationArguments Object
> Used on Windows only.
* `type` string - The type of activation that launched the app: `'click'`, `'action'`, or `'reply'`.
* `arguments` string - The raw activation arguments string from Windows.
* `actionIndex` number (optional) - For `'action'` type, the index of the button that was clicked.
* `reply` string (optional) - For `'reply'` type, the text the user entered in the reply field.
* `userInputs` Record\<string, string\> (optional) - A dictionary of all user inputs from the notification.