@jsenv/urls

url meta

Associate value to urls using pattern matching.

import { URL_META } from "@jsenv/urls"

// conditionally associates url and values
const associations = {
  color: {
    "file:///*": "black",
    "file:///*.js": "red",
  },
}
const getUrlColor = (url) => {
  return URL_META.applyAssociations({ url, associations }).color
}
console.log(`file.json color is ${getUrlColor("file:///file.json")}`)
console.log(`file.js color is ${getUrlColor("file:///file.js")}`)

Code above logs

file.json color is black
file.js color is red

Common pattern example

pattern	Description
**/	Everything
*/**/	Inside a directory
**/.*/	Inside directory starting with a dot
**/node_modules/	Inside any node_modules directory
node_modules/	Inside root node_modules directory
**/*.map	Ending with .map
**/*.test.*	Contains .test.
*	Inside the root directory only
*/*	Inside a directory of depth 1

Read more at ./pattern_matching.md

associations

associations below translates into: "files are visible except thoose in .git/ directory"

const associations = {
  visible: {
    "**/*/": true,
    "**/.git/": false,
  },
}

associations allows to group patterns per property which are easy to read and compose. All keys in associations must be absolute urls, this can be done with resolveAssociations.

resolveAssociations

resolveAssociations is a function resolving associations keys that may contain relative urls against an url.

import { URL_META } from "@jsenv/urls"

const associations = URL_META.resolveAssociations(
  {
    visible: {
      "**/*/": true,
      "**/.git/": false,
    },
  },
  "file:///Users/directory/",
)
console.log(JSON.stringify(associations, null, "  "))

{
  "visible": {
    "file:///Users/directory/**/*/": true,
    "file:///Users/directory/**/.git/": false
  }
}

Changelog

31.0.0

• Major update on dependencies
• Update how to start dev server in https
• More validation on public function params (type errors thrown on unexpected params)
• "errored" execution status becomes "failed"