[Share] Remove Tag in Clipboard from Selected Items

[bloomingseed]

Description

Description:
This script removes the tag currently stored in the system clipboard from all selected items in Zotero—only if the tag exists on those items. Ideal for batch tag cleanup based on clipboard input.

Key Features:

• Reads plain text from system clipboard as the target tag.
• Scans each selected item for the presence of that tag.
• Skips items that don’t contain the tag.

Event

None

Operation

Script

Data

/**
 * Remove tag in clipboard from all selected Zotero items if present.
 * @author Zotero Community
 * @usage Remove tag in clipboard from all selected Zotero items if present.
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/515
 * @see https://github.com/windingwind/zotero-actions-tags/discussions/515
 */

if(item) return; // only execute the script once

// === Utility Functions ===

/**
 * Check if the given item has the specified tag.
 * @param {ZoteroItem} item - The Zotero item to check.
 * @param {string} tag - The tag to look for.
 * @returns {boolean} - True if the item has the tag.
 */
function hasTag(item, tag) {
  return item.getTags().some(t => t.tag === tag);
}

/**
 * Get a trimmed plain text value from clipboard.
 * @returns {string|null} - The tag string from clipboard or null.
 */
function getClipboardTag() {
  const tag = Zotero.Utilities.Internal.getClipboard("text/plain");
  return tag ? tag.trim() : null;
}

// === Main Logic ===

const clipboardTag = getClipboardTag();

if (!clipboardTag) return;

for (const item of items) {
  if (hasTag(item, clipboardTag)) {
    item.removeTag(clipboardTag);
    item.saveTx();
  }
}

Anything else

No response