feat: search on WebCite

src/action/App.vue

@@ -404,7 +404,7 @@ export default {
       // Samsung Internet 18: tabs.getCurrent returns a tab
       // instead of undefined, and tab.id refers to a nonexistent tab.
       if (
-        isValidTab(currentTab) &&
+        (await isValidTab({tab: currentTab})) &&
         !this.$env.isSafari &&
         !this.$env.isSamsung
       ) {

src/assets/locales/en/messages.json

@@ -74,6 +74,11 @@
     "description": "Name of the search engine."
   },
 
+  "engineName_webcite": {
+    "message": "WebCite",
+    "description": "Name of the search engine."
+  },
+
   "engineName_allEngines": {
     "message": "All search engines",
     "description": "Name of the search engine."
@@ -160,6 +165,11 @@
     "description": "Title of the menu item."
   },
 
+  "menuItemTitle_webcite": {
+    "message": "WebCite",
+    "description": "Title of the menu item."
+  },
+
   "menuItemTitle_allEngines": {
     "message": "All search engines",
     "description": "Title of the menu item."
@@ -261,6 +271,11 @@
     "description": "Title of the option."
   },
 
+  "optionTitle_WebCite": {
+    "message": "WebCite",
+    "description": "Title of the option."
+  },
+
   "optionTitle_searchMode": {
     "message": "Search mode",
     "description": "Title of the option."

src/background/main.js

@@ -281,6 +281,8 @@ async function getTabUrl(session, search, doc, taskId) {
       '{date}',
       date.toISOString().split('.')[0].replace(/[-T:]/g, '')
     );
+  } else if (engine === 'webcite') {
+    tabUrl = tabUrl.replace('{date}', new Date().toISOString().split('T')[0]);
   }
 
   tabUrl = tabUrl.replace(/{url}/g, url);
@@ -507,7 +509,7 @@ async function openCurrentDoc({linkUrl} = {}) {
 }
 
 async function onContextMenuItemClick(info, tab) {
-  if (targetEnv === 'samsung' && isValidTab(tab)) {
+  if (targetEnv === 'samsung' && (await isValidTab({tab}))) {
     // Samsung Internet 13: contextMenus.onClicked provides wrong tab index.
     tab = await browser.tabs.get(tab.id);
   }
@@ -540,7 +542,7 @@ async function onActionClick(session, docUrl) {
 }
 
 async function onActionButtonClick(tab) {
-  if (targetEnv === 'samsung' && isValidTab(tab)) {
+  if (targetEnv === 'samsung' && (await isValidTab({tab}))) {
     // Samsung Internet 13: browserAction.onClicked provides wrong tab index.
     tab = await browser.tabs.get(tab.id);
   }
@@ -762,7 +764,7 @@ async function processMessage(request, sender) {
       sender.tab = null;
     }
 
-    if (isValidTab(sender.tab)) {
+    if (await isValidTab({tab: sender.tab})) {
       // Samsung Internet 13: runtime.onMessage provides wrong tab index.
       sender.tab = await browser.tabs.get(sender.tab.id);
     }

src/storage/config.json

@@ -14,7 +14,8 @@
       "20230703074609_remove_gigablast",
       "20230704125533_remove_opencurrentdocaction",
       "20230713165504_add_perma.cc",
-      "20230715152710_add_ghostarchive"
+      "20230715152710_add_ghostarchive",
+      "20230718120215_add_webcite"
     ],
     "sync": []
   }

src/storage/revisions/local/20230718120215_add_webcite.js

@@ -0,0 +1,21 @@
+const message = 'Add WebCite';
+
+const revision = '20230718120215_add_webcite';
+
+async function upgrade() {
+  const changes = {};
+  const {engines, disabledEngines} = await browser.storage.local.get([
+    'engines',
+    'disabledEngines'
+  ]);
+
+  const newEngines = ['webcite'];
+
+  changes.engines = engines.concat(newEngines);
+  changes.disabledEngines = disabledEngines.concat(newEngines);
+
+  changes.storageVersion = revision;
+  return browser.storage.local.set(changes);
+}
+
+export {message, revision, upgrade};

src/tools/main.js

@@ -51,6 +51,12 @@ function main() {
           docUrl = document.querySelector('._livepage a')?.href;
         } else if (engine === 'ghostarchive') {
           docUrl = document.querySelector('#searchInput')?.value;
+        } else if (engine === 'webcite') {
+          docUrl = document
+            .querySelector('frame[name="nav"]')
+            ?.contentDocument.querySelector(
+              'tr:first-child td:nth-child(2) a'
+            )?.href;
         }
 
         break;

src/utils/app.js

@@ -161,9 +161,13 @@ function normalizeUrl(url) {
   return parsedUrl.toString();
 }
 
-async function getOpenerTabId(openerTab) {
-  if (isValidTab(openerTab) && !(await getPlatform()).isMobile) {
-    return openerTab.id;
+async function getOpenerTabId({tab, tabId = null} = {}) {
+  if (!tab && tabId !== null) {
+    tab = await browser.tabs.get(tabId).catch(err => null);
+  }
+
+  if ((await isValidTab({tab})) && !(await getPlatform()).isMobile) {
+    return tab.id;
   }
 
   return null;
@@ -182,7 +186,7 @@ async function showPage({
   const props = {url, index: activeTab.index + 1, active: true, getTab};
 
   if (setOpenerTab) {
-    props.openerTabId = await getOpenerTabId(activeTab);
+    props.openerTabId = await getOpenerTabId({tab: activeTab});
   }
 
   return createTab(props);

src/utils/common.js

@@ -394,7 +394,11 @@ function makeDocumentVisible() {
   script.remove();
 }
 
-function isValidTab(tab) {
+async function isValidTab({tab, tabId = null} = {}) {
+  if (!tab && tabId !== null) {
+    tab = await browser.tabs.get(tabId).catch(err => null);
+  }
+
   if (tab && tab.id !== browser.tabs.TAB_ID_NONE) {
     return true;
   }

src/utils/data.js

@@ -65,6 +65,9 @@ const engines = {
   ghostarchive: {
     target: 'https://ghostarchive.org/search?term={url}',
     isExec: true
+  },
+  webcite: {
+    target: 'https://webcitation.org/query?url={url}&date={date}'
   }
 };
 
@@ -77,7 +80,8 @@ const engineIconAlias = {
 const engineIconVariants = {
   archiveOrg: ['dark'],
   archiveIs: ['dark'],
-  yahoo: ['dark']
+  yahoo: ['dark'],
+  webcite: ['dark']
 };
 
 const rasterEngineIcons = ['ghostarchive'];
@@ -128,7 +132,8 @@ const pageArchiveHosts = {
   bing: ['cc.bingj.com'],
   yandex: ['yandexwebcache.net'],
   permacc: ['perma.cc', 'rejouer.perma.cc'],
-  ghostarchive: ['ghostarchive.org']
+  ghostarchive: ['ghostarchive.org'],
+  webcite: ['webcitation.org']
 };
 
 const linkArchiveHosts = {