JavaScript: Dismiss a rejection

dismissRejection(mutationId) flags one journal entry as acknowledged. It stops appearing in List rejections unless that call asks for dismissed entries too.

Examples#

Basic#

// src/todo-list.ts
import type { TRejectionRecord } from 'kizunasync'
import { kizunasync } from './kizunasync'

export async function acknowledgeRejection(record: TRejectionRecord): Promise<void> {
  await kizunasync.dismissRejection(record.mutationId)
}

Acknowledge everything shown#

// src/todo-list.ts
import { kizunasync } from './kizunasync'

for (const record of await kizunasync.rejections()) {
  await kizunasync.dismissRejection(record.mutationId)
}

Parameters#

Returns#

Promise<void> that settles once the flag is written. The entry stays in the journal with dismissed set to true, so a later call that passes includeDismissed returns it regardless.

Errors#

This method throws nothing. An id that matches no entry updates no rows and settles normally, so dismissing twice is safe.

Notes#

Dismissing is an acknowledgement, not a retry. The write is already gone. The verdict clears its outbox entry on arrival and reverts the local row to the server state. Only a new write recovers the change, once the app fixes whatever the reason names. Read the journal in the app shows both halves.

React: useRejections returns this method beside the journal rows, so a component lists and acknowledges through one hook.

The flag is client-local, like the journal itself. It is not pushed, another device does not learn about it, and Reset deletes the entry along with everything else.

Related reference#

• List rejections
• Subscribe to events
• Reset
• Swift: Dismiss a rejection
• Kotlin: Dismiss a rejection