yomichan/ext/bg/js/anki.js

167 lines
5.0 KiB
JavaScript
Raw Normal View History

2016-10-11 02:50:55 +00:00
/*
* Copyright (C) 2016-2020 Yomichan Authors
2016-10-11 02:50:55 +00:00
*
* 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
2020-01-01 17:00:31 +00:00
* along with this program. If not, see <https://www.gnu.org/licenses/>.
2016-10-11 02:50:55 +00:00
*/
class AnkiConnect {
constructor() {
2020-04-12 16:38:33 +00:00
this._enabled = false;
this._server = null;
2020-04-12 16:20:02 +00:00
this._localVersion = 2;
this._remoteVersion = 0;
2020-08-09 17:17:15 +00:00
this._versionCheckPromise = null;
2016-10-11 02:50:55 +00:00
}
get server() {
2020-04-12 16:37:13 +00:00
return this._server;
}
set server(value) {
this._server = value;
2020-04-12 16:37:13 +00:00
}
get enabled() {
2020-04-12 16:37:13 +00:00
return this._enabled;
}
set enabled(value) {
this._enabled = value;
}
2017-07-10 23:24:31 +00:00
async addNote(note) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return null; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('addNote', {note});
2016-10-11 02:50:55 +00:00
}
2017-07-10 23:24:31 +00:00
async canAddNotes(notes) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('canAddNotes', {notes});
2016-10-11 02:50:55 +00:00
}
2017-07-10 23:24:31 +00:00
async getDeckNames() {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('deckNames');
2016-10-11 02:50:55 +00:00
}
2017-07-10 23:24:31 +00:00
async getModelNames() {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('modelNames');
2016-10-11 02:50:55 +00:00
}
2017-07-10 23:24:31 +00:00
async getModelFieldNames(modelName) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('modelFieldNames', {modelName});
2017-07-02 01:27:49 +00:00
}
2017-07-10 23:24:31 +00:00
async guiBrowse(query) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('guiBrowse', {query});
2016-10-11 02:50:55 +00:00
}
async guiBrowseNote(noteId) {
return await this.guiBrowse(`nid:${noteId}`);
}
async storeMediaFile(fileName, dataBase64) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) {
2020-04-12 16:43:24 +00:00
throw new Error('AnkiConnect not enabled');
2020-04-12 16:37:13 +00:00
}
2020-04-12 16:20:02 +00:00
await this._checkVersion();
return await this._invoke('storeMediaFile', {filename: fileName, data: dataBase64});
2016-10-11 02:50:55 +00:00
}
async findNoteIds(notes, duplicateScope) {
2020-04-12 16:37:13 +00:00
if (!this._enabled) { return []; }
2020-04-12 16:20:02 +00:00
await this._checkVersion();
const actions = notes.map((note) => {
let query = '';
switch (duplicateScope) {
case 'deck':
query = `"deck:${this._escapeQuery(note.deckName)}" `;
break;
case 'deck-root':
query = `"deck:${this._escapeQuery(this.getRootDeckName(note.deckName))}" `;
break;
}
query += this._fieldsToQuery(note.fields);
return {action: 'findNotes', params: {query}};
});
return await this._invoke('multi', {actions});
2020-04-12 16:20:02 +00:00
}
getRootDeckName(deckName) {
const index = deckName.indexOf('::');
return index >= 0 ? deckName.substring(0, index) : deckName;
}
2020-04-12 16:20:02 +00:00
// Private
async _checkVersion() {
if (this._remoteVersion < this._localVersion) {
2020-08-09 17:17:15 +00:00
if (this._versionCheckPromise === null) {
const promise = this._invoke('version');
promise
.catch(() => {})
.finally(() => { this._versionCheckPromise = null; });
2020-08-09 17:17:15 +00:00
this._versionCheckPromise = promise;
}
this._remoteVersion = await this._versionCheckPromise;
2020-04-12 16:20:02 +00:00
if (this._remoteVersion < this._localVersion) {
throw new Error('Extension and plugin versions incompatible');
}
}
2019-10-10 00:27:05 +00:00
}
async _invoke(action, params) {
const response = await fetch(this._server, {
method: 'POST',
mode: 'cors',
cache: 'default',
credentials: 'omit',
redirect: 'follow',
referrerPolicy: 'no-referrer',
body: JSON.stringify({action, params, version: this._localVersion})
});
const result = await response.json();
2020-04-17 23:25:07 +00:00
if (isObject(result)) {
2020-04-12 16:43:24 +00:00
const error = result.error;
if (typeof error !== 'undefined') {
throw new Error(`AnkiConnect error: ${error}`);
}
}
return result;
2016-10-11 02:50:55 +00:00
}
2019-10-10 00:27:05 +00:00
2020-04-12 16:20:02 +00:00
_escapeQuery(text) {
2019-10-10 00:27:05 +00:00
return text.replace(/"/g, '');
}
2020-04-12 16:20:02 +00:00
_fieldsToQuery(fields) {
2019-10-10 00:27:05 +00:00
const fieldNames = Object.keys(fields);
if (fieldNames.length === 0) {
return '';
}
const key = fieldNames[0];
return `"${key.toLowerCase()}:${this._escapeQuery(fields[key])}"`;
2019-10-10 00:27:05 +00:00
}
2016-10-11 02:50:55 +00:00
}