yomichan/ext/js/comm/anki.js
toasted-nutbread fd00a52856
Anki findNotes (#2152)
* Add findNotes API

* Add api.findAnkiNotes
2022-05-21 15:28:44 -04:00

263 lines
7.9 KiB
JavaScript

/*
* Copyright (C) 2016-2022 Yomichan Authors
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
/* global
* AnkiUtil
*/
class AnkiConnect {
constructor() {
this._enabled = false;
this._server = null;
this._localVersion = 2;
this._remoteVersion = 0;
this._versionCheckPromise = null;
}
get server() {
return this._server;
}
set server(value) {
this._server = value;
}
get enabled() {
return this._enabled;
}
set enabled(value) {
this._enabled = value;
}
async isConnected() {
try {
await this._invoke('version');
return true;
} catch (e) {
return false;
}
}
async getVersion() {
if (!this._enabled) { return null; }
await this._checkVersion();
return await this._invoke('version', {});
}
async addNote(note) {
if (!this._enabled) { return null; }
await this._checkVersion();
return await this._invoke('addNote', {note});
}
async canAddNotes(notes) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('canAddNotes', {notes});
}
async notesInfo(notes) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('notesInfo', {notes});
}
async getDeckNames() {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('deckNames');
}
async getModelNames() {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('modelNames');
}
async getModelFieldNames(modelName) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('modelFieldNames', {modelName});
}
async guiBrowse(query) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('guiBrowse', {query});
}
async guiBrowseNote(noteId) {
return await this.guiBrowse(`nid:${noteId}`);
}
/**
* Stores a file with the specified base64-encoded content inside Anki's media folder.
* @param {string} fileName The name of the file.
* @param {string} content The base64-encoded content of the file.
* @returns {?string} The actual file name used to store the file, which may be different; or `null` if the file was not stored.
* @throws {Error} An error is thrown is this object is not enabled.
*/
async storeMediaFile(fileName, content) {
if (!this._enabled) {
throw new Error('AnkiConnect not enabled');
}
await this._checkVersion();
return await this._invoke('storeMediaFile', {filename: fileName, data: content});
}
/**
* Finds notes matching a query.
* @param {string} query Searches for notes matching a query.
* @returns {number[]} An array of note IDs.
* @see https://docs.ankiweb.net/searching.html
*/
async findNotes(query) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('findNotes', {query});
}
async findNoteIds(notes) {
if (!this._enabled) { return []; }
await this._checkVersion();
const actions = notes.map((note) => {
let query = '';
switch (this._getDuplicateScopeFromNote(note)) {
case 'deck':
query = `"deck:${this._escapeQuery(note.deckName)}" `;
break;
case 'deck-root':
query = `"deck:${this._escapeQuery(AnkiUtil.getRootDeckName(note.deckName))}" `;
break;
}
query += this._fieldsToQuery(note.fields);
return {action: 'findNotes', params: {query}};
});
return await this._invoke('multi', {actions});
}
async suspendCards(cardIds) {
if (!this._enabled) { return false; }
await this._checkVersion();
return await this._invoke('suspend', {cards: cardIds});
}
async findCards(query) {
if (!this._enabled) { return []; }
await this._checkVersion();
return await this._invoke('findCards', {query});
}
async findCardsForNote(noteId) {
return await this.findCards(`nid:${noteId}`);
}
// Private
async _checkVersion() {
if (this._remoteVersion < this._localVersion) {
if (this._versionCheckPromise === null) {
const promise = this._invoke('version');
promise
.catch(() => {})
.finally(() => { this._versionCheckPromise = null; });
this._versionCheckPromise = promise;
}
this._remoteVersion = await this._versionCheckPromise;
if (this._remoteVersion < this._localVersion) {
throw new Error('Extension and plugin versions incompatible');
}
}
}
async _invoke(action, params) {
let response;
try {
response = await fetch(this._server, {
method: 'POST',
mode: 'cors',
cache: 'default',
credentials: 'omit',
headers: {
'Content-Type': 'application/json'
},
redirect: 'follow',
referrerPolicy: 'no-referrer',
body: JSON.stringify({action, params, version: this._localVersion})
});
} catch (e) {
const error = new Error('Anki connection failure');
error.data = {action, params, originalError: e};
throw error;
}
if (!response.ok) {
const error = new Error(`Anki connection error: ${response.status}`);
error.data = {action, params, status: response.status};
throw error;
}
let responseText = null;
let result;
try {
responseText = await response.text();
result = JSON.parse(responseText);
} catch (e) {
const error = new Error('Invalid Anki response');
error.data = {action, params, status: response.status, responseText, originalError: e};
throw error;
}
if (isObject(result)) {
const apiError = result.error;
if (typeof apiError !== 'undefined') {
const error = new Error(`Anki error: ${apiError}`);
error.data = {action, params, status: response.status, apiError};
throw error;
}
}
return result;
}
_escapeQuery(text) {
return text.replace(/"/g, '');
}
_fieldsToQuery(fields) {
const fieldNames = Object.keys(fields);
if (fieldNames.length === 0) {
return '';
}
const key = fieldNames[0];
return `"${key.toLowerCase()}:${this._escapeQuery(fields[key])}"`;
}
_getDuplicateScopeFromNote(note) {
const {options} = note;
if (typeof options === 'object' && options !== null) {
const {duplicateScope} = options;
if (typeof duplicateScope !== 'undefined') {
return duplicateScope;
}
}
return null;
}
}