@pirxpilot/nanohref 1.0.0 → 2.1.0

package/README.md

@@ -36,15 +36,19 @@ following conditions:
 - the link's href starts with protocol handler such as `mailto:` or `dat:`
 - the link points to a different host
 - the link has a `download` attribute
+- the link's pathname does not start with the specified `prefix` (if provided)
 
 :warning: Note that we only handle `target=_blank` if they also have
 `rel="noopener"` on them. This is needed to [properly sandbox web
 pages](https://mathiasbynens.github.io/rel-noopener/).
 
 ## API
-### `nanohref(handler(location))`
+### `nanohref(handler(location), { prefix })`
 Create a new anchor click handler.
 
+- `handler(location)` - callback invoked with the new location on anchor click
+- `prefix` - optional pathname prefix; when provided, only links whose pathname starts with the prefix are handled
+
 ## See Also
 - [MDN/link-types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types)
 - [caniuse/rel=noopener](http://caniuse.com/#feat=rel-noopener)
@@ -59,7 +63,7 @@ Create a new anchor click handler.
 [npm-url]: https://npmjs.org/package/@pirxpilot/nanohref
 
 [build-url]: https://github.com/pirxpilot/nanohref/actions/workflows/check.yaml
-[build-image]: https://img.shields.io/github/workflow/status/pirxpilot/nanohref/check
+[build-image]: https://img.shields.io/github/actions/workflow/status/pirxpilot/nanohref/check.yaml?branch=main
 
 [deps-image]: https://img.shields.io/librariesio/release/npm/@pirxpilot/nanohref
 [deps-url]: https://libraries.io/npm/@pirxpilot%2Fnanohref

package/index.js

@@ -1,30 +1,30 @@
-const assert = require('assert')
+import assert from 'assert';
 
-const safeExternalLink = /noopener/
-const protocolLink = /^[\w-_]+:/
+const safeExternalLink = /noopener/;
+const protocolLink = /^[\w-_]+:/;
 
-module.exports = href
-
-function href (cb) {
-  assert(typeof cb === 'function', 'nanohref: cb should be type function')
+export default function href(cb, { prefix }) {
+  assert(typeof cb === 'function', 'nanohref: cb should be type function');
 
   window.addEventListener('click', e => {
-    if ((e.button && e.button !== 0) ||
-      e.ctrlKey || e.metaKey || e.altKey || e.shiftKey ||
-      e.defaultPrevented) return
+    if ((e.button && e.button !== 0) || e.ctrlKey || e.metaKey || e.altKey || e.shiftKey || e.defaultPrevented) return;
 
-    const anchor = e.target.closest('a[href]')
-    if (!anchor) return
+    const anchor = e.target.closest('a[href]');
+    if (!anchor) return;
 
-    if (window.location.protocol !== anchor.protocol ||
+    if (
+      window.location.protocol !== anchor.protocol ||
       window.location.hostname !== anchor.hostname ||
       window.location.port !== anchor.port ||
+      (prefix && !anchor.pathname.startsWith(prefix)) ||
       anchor.hasAttribute('data-nanohref-ignore') ||
       anchor.hasAttribute('download') ||
       (anchor.getAttribute('target') === '_blank' && safeExternalLink.test(anchor.getAttribute('rel'))) ||
-      protocolLink.test(anchor.getAttribute('href'))) return
+      protocolLink.test(anchor.getAttribute('href'))
+    )
+      return;
 
-    e.preventDefault()
-    cb(anchor)
-  })
+    e.preventDefault();
+    cb(anchor);
+  });
 }

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@pirxpilot/nanohref",
   "description": "Tiny href click handler library",
-  "repository": "pirxpilot/nanohref",
-  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pirxpilot/nanohref.git"
+  },
+  "version": "2.1.0",
   "scripts": {
-    "test": "standard"
+    "test": "make check"
   },
+  "type": "module",
+  "exports": "./index.js",
   "browser": {
     "assert": "@pirxpilot/nanoassert"
   },
@@ -13,7 +18,7 @@
     "@pirxpilot/nanoassert": "~1"
   },
   "devDependencies": {
-    "standard": "~17"
+    "@biomejs/biome": "2.4.11"
   },
   "keywords": [
     "nano",
@@ -26,4 +31,4 @@
   "files": [
     "index.js"
   ]
-}
+}