anki/ts/editor/change-timer.ts

// Copyright: Ankitects Pty Ltd and contributors
// License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html

import type { EditingArea } from "./editing-area";

import { getCurrentField } from "./helpers";
import { bridgeCommand } from "./lib";
import { getNoteId } from "./note-id";

let changeTimer: number | null = null;

export function triggerChangeTimer(currentField: EditingArea): void {
    clearChangeTimer();
    changeTimer = setTimeout(() => saveField(currentField, "key"), 600);
}

function clearChangeTimer(): void {
    if (changeTimer) {
        clearTimeout(changeTimer);
        changeTimer = null;
    }
}

export function saveField(currentField: EditingArea, type: "blur" | "key"): void {
    clearChangeTimer();
    const command = `${type}:${currentField.ord}:${getNoteId()}:${
        currentField.fieldHTML
    }`;
    bridgeCommand(command);
}

export function saveNow(keepFocus: boolean): void {
    const currentField = getCurrentField();

    if (!currentField) {
        return;
    }

    clearChangeTimer();

    if (keepFocus) {
        saveField(currentField, "key");
    } else {
        // triggers onBlur, which saves
        currentField.blur();
    }
}