Skip to content

EditBacklinksSnapshotParams<TPayload>

Parameters for editBacklinksSnapshot.

Import:

import type { EditBacklinksSnapshotParams } from '@mnaoumov/obsidian-lib/link';

Signature:

export interface EditBacklinksSnapshotParams<TPayload> extends EditBacklinksSnapshotOptions

Extends: EditBacklinksSnapshotOptions

Properties

PropertyTypeDescription
appAppThe Obsidian application instance.
linkConverter(params: BacklinkConversionParams<TPayload>) => Promisable<MaybeReturn<string>>The function that converts each link.
linkIdentityKeyProvider?(link: Reference) => stringComputes the identity key of a link.

Leave it out for a snapshot made by buildBacklinksSnapshot: the snapshot carries the provider it was built with, and that one is used. Passing a different one throws, because the snapshot is keyed by the other and not a single link would match — the edit would complete and rewrite nothing. It is needed only for a snapshot assembled by hand.
linkUpdateProgressReporter?LinkUpdateProgressReporterAn optional reporter invoked once per backlink file after its links are updated, with the running count of processed files and the total. When omitted, no progress is reported.
shouldVisitUnmatchedLinks?booleanWhether the converter is also shown links that are **not** in the snapshot, with an undefined BacklinkConversionParams.payload.

The default filters them out, which is what a plain rename wants: a link absent from the snapshot was either never the caller's to rewrite, or has already been rewritten by someone else. Set this to true only when the caller has its own reason to look at them — a widened match of its own, or logging a skip that would otherwise be silent.
snapshotBacklinksSnapshot<TPayload>The captured backlinks to edit.

Links to this page: