Format - k08045kk/CopyTabTitleUrl GitHub Wiki

You can freely create copy strings using the format ${value}.

• Idea✨ (Unimplemented): Allows you to choose the prefix and suffix.
  • Example: ${value}, %value%, {{value}}

※ Non-standard features will not work unless "Extended Mode" is enabled.

※1: Used in the context menus.
※2: Used in the selection context menus.
　　You can use it outside of the context menu by enabling [Use content script for active tab 🧪🧪].
※3: Used in the link context menu.
※4: Used in the image context menu.
※🗑️ Deprecated: ${TITLE}, ${URL}, ${ENTER}, ${TEXT}, ${selectedText}, ${INDEX}, ${id}, ${ID}

※🗑️ Deprecated: ${\r}, ${\n}, ${\t}, ${r}, ${n}, ${t}, ${cr}, ${lf}, ${tab}
※ In particular, the use of ${tab} is discouraged. (because it may be used in Programmable Format)

※ see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus/OnClickData
※ You can also browse from multiple tabs.

※ ${yyyy}-${MM}-${dd}T${HH}:${mm}:${ss}.${SSS}
　2020-04-03T00:48:23.456

※ If (data) does not exist, it is treated as an empty string.
※ ${protocol}//${host}${pathname}${search}${hash}
　https://example.com/path/file?key=value&query#hash
※ window.URL - Web API | MDN
※1: May return null for protocols other than: http, https, ftp, ws, wss
※2: It is commonly used as "${protocol}//", but be aware that this will cause issues with the following URL:
　　about:about
　　view-source:https://[email protected]/k08045kk

Plain:
${title}${enter}${url}
${title}
${url}

Markdown:
[${title}](${url})

HTML:
<a href="${url}">${title}</a>
<a href="${url}">${title}</a><br/>
<p><a href="${url}">${title}</a></p>
<a href="${url}" target="_blank" rel="noopener">${title}</a>

LaTeX:
\url{${url}}
\href{${url}}{${title}}
	
Redmine:
"${title}":${url}

reStructuredText:
`${title} <${url}>`_

※ No automatic escaping to format strings is performed.

• [Enable programmable format 🧪🧪] [v3.1.0]
  • Alias, function name: programmable format, programmable
  • The format can be extended using functions and assignments.
    • Please do not write complicated processing using this function.
    • This feature exists to connect multiple features.
      • browser information, regular expressions, user scripts, external programs.
  • I believe this functionality does not apply to remote code.
    • If it turns out to be remote code or something similar, I will protect the extension by removing this feature.
  • The option appears when you enable [Use Extended Edit Mode 🧪].
  • Please check the source code for details on this feature.
    • /background/compiler.js

※ Types are automatically converted.
　Example: ${Math.not(false)}, ${Math.not(0)}, ${Math.not(-0)},
　　　　　　${Math.not(null)}, ${Math.not(NaN)}, ${Math.not('')} // output: true
　Example: ${Math.not('string')}, ${Math.not('false')}, ${Math.not(-1)} // output: false
※1: Numeric values should be defined in a form that matches the following regular expression: /^[+\-]?\d+$/
※2: String values should be defined in a form that matches the following regular expression: /^("[^"}]*"|'[^'}]*')$/
※3: see https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab

※1: Enable browser developer mode
Math.fn(): add / sub / mul / div / mod / and / or / not / random
Math.fn(): lt / lte / gt / gte / eq / neq / seq / nseq / cond / ncond / any
String.fn(): fromCharCode / fromCodePoint
　　see String - JavaScript | MDN
Date.fn(): toDateString / toISOString / toString / toTimeString / toUTCString / toLocaleDateString / toLocaleString / toLocaleTimeString
　　see Date - JavaScript | MDN
Array.fn(): at / concat / includes / indexOf / isArray / join / pop / push / reverse / shift / slice / splice / unshift / with
　　see Array - JavaScript | MDN

※ Some specifications differ from standard JavaScript functions.
※1: Reserved words (reserved words may increase in the future)
　　Math, String, true, false, null, undefined, NaN, Infinity, $, title, url

in.fn: length
in.fn(): replace / replaceAll / match / search / substring / slice / padStart / padEnd / at / charAt / charCodeAt / codePointAt / repeat / startsWith / endsWith / includes / indexOf / lastIndexOf / normalize / concat / split / isWellFormed / trim / trimStart / trimEnd / toLocaleLowerCase / toLocaleUpperCase / toLowerCase / toString / toUpperCase / toWellFormed / valueOf
see String - JavaScript | MDN
※ Items that are not significantly different from JavaScript will be omitted.
※ Arguments that accept regular expressions only accept regular expressions.
※ Returns an empty string instead of null.

Markdown escaped title:
format = ${title.replaceAll(text0,'\$&')}
${text0} = [*_\\`#+\-.!{}[\]()]

Amazon.com shortened URL
format = ${url.replace(text0,"$1$2")}
${text0} = ^(https?:\/\/www\.amazon\.(?:com|co\.jp))(?:\/.*)?(\/dp\/\w+)[\/\?#]?.*$

Localize the day of week
format = ${text0[dayOfWeek]}
${text0} = ["日","月","火","水","木","金","土"]

Localize the AM/PM
format = ${ampm=Math.div(H,12)}${text0[ampm]}
${text0} = ["午前","午後"]

Control character output
format = ${String.fromCodePoint(9)}

Branch processing for each site
format = ${text0[hostname]}
${text0} = {"www.google.com":"Google","github.com":"GitHub"}

Branch processing for each site
format = ${x=Math.eq(hostname,text0)}${Math.cond(x,"Google")}${Math.condn(x,"not Google")}
${text0} = www.google.com

• If parsing fails, leave the syntax as is.
  • ${x}->${x}
• If an error occurs during execution, include the error.
  • ${x}->${x}[Error: ....]
• The syntax must not contain whitespace.
  • ${x.replace('abc', 'xyz')}
  • error ^
• Note that assignment breaks existing variables.
• Compilation of separator is performed only once, at the beginning.
  • This feature comes into play when setting initial values.
• At this time, we disclaim all warranties including compatibility.

• [Use content script for active tab 🧪🧪] [v3.1.0]
  • Alias, function name: scripting, content script
  • Use page content using content script.
  • Selection text can be used outside of context menus.
  • Works on active tab.
    • Use activeTab permission.
    • Does not use host permission.
  • Idea✨ (Unimplemented): Option to force disable the script: ${scripting=false}
  • Idea✨ (Unimplemented): Option to force enable the script: ${scripting=true}
  • The option appears when you enable [Use Extended Edit Mode 🧪].
  • Please check the source code for details on this feature.
    • /background/scripting.js
• [Use content script for all frames 🧪🧪] [v3.4.4]
  • Selection text works even when subframes are selected.
    • If the selection spans multiple frames, the selected string of the first frame will be output.
  • Currently, this feature has no effect on anything other than the selection string.
  • However, there seems to be a problem with some sites not returning responses (#66)
    • Therefore, we set a timeout of 150ms.
  • It is recommended that this setting not be easily enabled and only be enabled when necessary.
• [Inject content script after page loaded 🧪🧪] (v3.5.6)
  • ✅ If enabled, insert the content scripts after the page loading is complate.
    • This timing is commonly referred to as document_idle.
    • In a slow-loading environment, this feels slower than expected.
    • If you wait for the page to load, you may feel uncomfortable with pop-ups and other displays.
  • ⬜ If disabled, the script will be inserted immediately.
    • Therefore, the page may not have finished loading. It is also possible that the user script has not yet been executed.
    • As a result, retrieval of some data may fail.
      • ${pageTitle}, ${pageH1}, ${pageText0}, etc...

※ Scripting does not work on pages where content scripts do not work.
　 Example: chrome://, mozilla.org
※ It may be changed to ${scripting.prop} in the future.
※1: [Show completion popup] does not work.
※2: Does not work with mobile popup display.
※3: ${pagePrompt} has no timeout setting. Therefore, processing may stop.
　　 Please consider carefully when using (#66)
※ Scripting does not work on pages where content scripts do not work.

• Creating strings with multiple conditions
  • ${metaTitle} or ${ogTitle} or ${pageTitle} or ${title}
  • ${x=title}${x=Math.cond(pageTitle)}${x=Math.cond(ogTitle)}${x=Math.cond(metaTitle)}${x}
• If there are items, output them together with subordinate sentences.
  • ... or ... 説明「..description.」
  • ...${x=' 説明「'.concat(ogpDescription,'」')}${Math.cond(ogpDescription,x)}
• Creating a snippet
  • Description: ${ogpDescription.snippet(100)}
  • Description: ${x=ogpDescription.slice(0,100)}${x=x.trim()}${len=ogpDescription.length}${y=Math.gte(len,100)}${z=''}${z=Math.cond(y,'...')}${x.concat(z)}

• [Enable content script for main world 🧪🧪] [v3.3.6]
  • Alias, function name: scripting, main scripting, main content script
  • Non-string values are treated as strings: window.CopyTabTitleUrl?.text0?.toString() ?? ''
  • Read values from main world. However, no writing is done.
  • If you write a value to window, it may be used as fingerprinting. Please use with caution.
  • Possible use is to switch format on a site-by-site basis.
    • ${pageText0} or ${title}${enter}${url}
    • ${Math.cond(pageText0)}${x=title.concat(enter,url)}${Math.condn(pageText0,x)}
  • Possible use is to write a user script to describe an overly complex format.

// ==UserScript==
// @name        window.CopyTabTitleUrl.text0
// @include     *
// @grant       none
// ==/UserScript==

window.CopyTabTitleUrl = window.CopyTabTitleUrl || {};
window.CopyTabTitleUrl.text0 = 'main world text';

• [Enable ${text0} - ${text9} 🧪🧪] [v3.3.4]
  • Alias, function name: Text, ${textn}
  • The option appears when you enable [Use Extended Edit Mode 🧪].

• [Enable ${menu} 🧪🧪] [v3.4.1]
  • Alias, function name: Extended Context Menu, ${menu}
  • You must enable [Enable programmable format 🧪🧪][Enable ${text0} - ${text9} 🧪🧪] to use it.
  • ${text0} = ${menu=true}${menuTitle='format10'}${menuTarget='tab'}[${title}](${url})
  • Expansion to format strings needs to be considered. (if there is a strong demand, we will consider it)
  • If you need this feature, please let me know how to use it. (how many, format)

※1: see https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus/ContextType
※2: see https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns

• Set the start and end text of the text to copy 🧪🧪 [v3.4.3]
  • Alias, function name: ${copyStartText}, ${copyEndText}
  • You must enable [Enable programmable format 🧪🧪] to use it.
  • Enable JSON format for objects and arrays.
    • separator = ${startText='["'}", "${endText='"]'}
    • separator = ${startText='{'}, ${endText=String.fromCharCode(125)}

• There is a function to delete the spaces of line feed characters that are automatically inserted when copying and pasting to the options screen. This is useful when writing complex formats.
  • [Remove newlines when paste 🧪🧪]
• For processes that are too complex, consider using external programs, user scripts, or bookmarklets.
  • The following functions allow you to decorate the output. This is useful when having external programs read data.
    • ${copyStartText}, ${copyEndText}, ${copySeparator}
  • The following functions allow you to copy input from user scripts.
    • This makes writing complex code easier.
    • Additionally, browser actions, context menus, and shortcut key launch actions become available.
    • ${pageText0} - ${pageText9}
  • A sample user script or bookmarklet is shown below. Please consider copying without using this extension.

(function() {
  window.addEventListener('copy', function(event) {
    event.preventDefault();
    event.stopImmediatePropagation();
    
    var text = '['+document.title+']('+document.URL+')';
    event.clipboardData.setData('text/plain', text);
  }, {capture:true, once:true});
  document.execCommand('copy');
})();

javascript:(function(){window.addEventListener('copy',function(a){a.preventDefault();a.stopImmediatePropagation();a.clipboardData.setData('text/plain','['+document.title+']('+document.URL+')')},{capture:!0,once:!0});document.execCommand('copy')})();