Aktueller Stand

This commit is contained in:
2026-01-22 19:05:45 +01:00
parent 85dee61a4d
commit e280e4eadb
1967 changed files with 397327 additions and 74093 deletions

View File

@@ -1,53 +1,99 @@
'use strict'
const { HEX } = require('./scopedChars')
/** @type {(value: string) => boolean} */
const isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu)
function normalizeIPv4 (host) {
if (findToken(host, '.') < 3) { return { host, isIPV4: false } }
const matches = host.match(/^(\b[01]?\d{1,2}|\b2[0-4]\d|\b25[0-5])(\.([01]?\d{1,2}|2[0-4]\d|25[0-5])){3}$/u) || []
const [address] = matches
if (address) {
return { host: stripLeadingZeros(address, '.'), isIPV4: true }
} else {
return { host, isIPV4: false }
}
}
/** @type {(value: string) => boolean} */
const isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u)
function stringToHexStripped (input) {
/**
* @param {Array<string>} input
* @returns {string}
*/
function stringArrayToHexStripped (input) {
let acc = ''
let strip = true
for (const c of input) {
if (c !== '0' && strip === true) strip = false
if (HEX[c] === undefined) return undefined
if (!strip) acc += c
let code = 0
let i = 0
for (i = 0; i < input.length; i++) {
code = input[i].charCodeAt(0)
if (code === 48) {
continue
}
if (!((code >= 48 && code <= 57) || (code >= 65 && code <= 70) || (code >= 97 && code <= 102))) {
return ''
}
acc += input[i]
break
}
for (i += 1; i < input.length; i++) {
code = input[i].charCodeAt(0)
if (!((code >= 48 && code <= 57) || (code >= 65 && code <= 70) || (code >= 97 && code <= 102))) {
return ''
}
acc += input[i]
}
return acc
}
/**
* @typedef {Object} GetIPV6Result
* @property {boolean} error - Indicates if there was an error parsing the IPv6 address.
* @property {string} address - The parsed IPv6 address.
* @property {string} [zone] - The zone identifier, if present.
*/
/**
* @param {string} value
* @returns {boolean}
*/
const nonSimpleDomain = RegExp.prototype.test.bind(/[^!"$&'()*+,\-.;=_`a-z{}~]/u)
/**
* @param {Array<string>} buffer
* @returns {boolean}
*/
function consumeIsZone (buffer) {
buffer.length = 0
return true
}
/**
* @param {Array<string>} buffer
* @param {Array<string>} address
* @param {GetIPV6Result} output
* @returns {boolean}
*/
function consumeHextets (buffer, address, output) {
if (buffer.length) {
const hex = stringArrayToHexStripped(buffer)
if (hex !== '') {
address.push(hex)
} else {
output.error = true
return false
}
buffer.length = 0
}
return true
}
/**
* @param {string} input
* @returns {GetIPV6Result}
*/
function getIPV6 (input) {
let tokenCount = 0
const output = { error: false, address: '', zone: '' }
/** @type {Array<string>} */
const address = []
/** @type {Array<string>} */
const buffer = []
let isZone = false
let endipv6Encountered = false
let endIpv6 = false
function consume () {
if (buffer.length) {
if (isZone === false) {
const hex = stringToHexStripped(buffer.join(''))
if (hex !== undefined) {
address.push(hex)
} else {
output.error = true
return false
}
}
buffer.length = 0
}
return true
}
let consume = consumeHextets
for (let i = 0; i < input.length; i++) {
const cursor = input[i]
@@ -56,41 +102,51 @@ function getIPV6 (input) {
if (endipv6Encountered === true) {
endIpv6 = true
}
if (!consume()) { break }
tokenCount++
address.push(':')
if (tokenCount > 7) {
if (!consume(buffer, address, output)) { break }
if (++tokenCount > 7) {
// not valid
output.error = true
break
}
if (i - 1 >= 0 && input[i - 1] === ':') {
if (i > 0 && input[i - 1] === ':') {
endipv6Encountered = true
}
address.push(':')
continue
} else if (cursor === '%') {
if (!consume()) { break }
if (!consume(buffer, address, output)) { break }
// switch to zone detection
isZone = true
consume = consumeIsZone
} else {
buffer.push(cursor)
continue
}
}
if (buffer.length) {
if (isZone) {
if (consume === consumeIsZone) {
output.zone = buffer.join('')
} else if (endIpv6) {
address.push(buffer.join(''))
} else {
address.push(stringToHexStripped(buffer.join('')))
address.push(stringArrayToHexStripped(buffer))
}
}
output.address = address.join('')
return output
}
function normalizeIPv6 (host, opts = {}) {
/**
* @typedef {Object} NormalizeIPv6Result
* @property {string} host - The normalized host.
* @property {string} [escapedHost] - The escaped host.
* @property {boolean} isIPV6 - Indicates if the host is an IPv6 address.
*/
/**
* @param {string} host
* @returns {NormalizeIPv6Result}
*/
function normalizeIPv6 (host) {
if (findToken(host, ':') < 2) { return { host, isIPV6: false } }
const ipv6 = getIPV6(host)
@@ -101,35 +157,17 @@ function normalizeIPv6 (host, opts = {}) {
newHost += '%' + ipv6.zone
escapedHost += '%25' + ipv6.zone
}
return { host: newHost, escapedHost, isIPV6: true }
return { host: newHost, isIPV6: true, escapedHost }
} else {
return { host, isIPV6: false }
}
}
function stripLeadingZeros (str, token) {
let out = ''
let skip = true
const l = str.length
for (let i = 0; i < l; i++) {
const c = str[i]
if (c === '0' && skip) {
if ((i + 1 <= l && str[i + 1] === token) || i + 1 === l) {
out += c
skip = false
}
} else {
if (c === token) {
skip = true
} else {
skip = false
}
out += c
}
}
return out
}
/**
* @param {string} str
* @param {string} token
* @returns {number}
*/
function findToken (str, token) {
let ind = 0
for (let i = 0; i < str.length; i++) {
@@ -138,99 +176,161 @@ function findToken (str, token) {
return ind
}
const RDS1 = /^\.\.?\//u
const RDS2 = /^\/\.(?:\/|$)/u
const RDS3 = /^\/\.\.(?:\/|$)/u
const RDS5 = /^\/?(?:.|\n)*?(?=\/|$)/u
function removeDotSegments (input) {
/**
* @param {string} path
* @returns {string}
*
* @see https://datatracker.ietf.org/doc/html/rfc3986#section-5.2.4
*/
function removeDotSegments (path) {
let input = path
const output = []
let nextSlash = -1
let len = 0
while (input.length) {
if (input.match(RDS1)) {
input = input.replace(RDS1, '')
} else if (input.match(RDS2)) {
input = input.replace(RDS2, '/')
} else if (input.match(RDS3)) {
input = input.replace(RDS3, '/')
output.pop()
} else if (input === '.' || input === '..') {
input = ''
} else {
const im = input.match(RDS5)
if (im) {
const s = im[0]
input = input.slice(s.length)
output.push(s)
// eslint-disable-next-line no-cond-assign
while (len = input.length) {
if (len === 1) {
if (input === '.') {
break
} else if (input === '/') {
output.push('/')
break
} else {
throw new Error('Unexpected dot segment condition')
output.push(input)
break
}
} else if (len === 2) {
if (input[0] === '.') {
if (input[1] === '.') {
break
} else if (input[1] === '/') {
input = input.slice(2)
continue
}
} else if (input[0] === '/') {
if (input[1] === '.' || input[1] === '/') {
output.push('/')
break
}
}
} else if (len === 3) {
if (input === '/..') {
if (output.length !== 0) {
output.pop()
}
output.push('/')
break
}
}
if (input[0] === '.') {
if (input[1] === '.') {
if (input[2] === '/') {
input = input.slice(3)
continue
}
} else if (input[1] === '/') {
input = input.slice(2)
continue
}
} else if (input[0] === '/') {
if (input[1] === '.') {
if (input[2] === '/') {
input = input.slice(2)
continue
} else if (input[2] === '.') {
if (input[3] === '/') {
input = input.slice(3)
if (output.length !== 0) {
output.pop()
}
continue
}
}
}
}
// Rule 2E: Move normal path segment to output
if ((nextSlash = input.indexOf('/', 1)) === -1) {
output.push(input)
break
} else {
output.push(input.slice(0, nextSlash))
input = input.slice(nextSlash)
}
}
return output.join('')
}
function normalizeComponentEncoding (components, esc) {
/**
* @param {import('../types/index').URIComponent} component
* @param {boolean} esc
* @returns {import('../types/index').URIComponent}
*/
function normalizeComponentEncoding (component, esc) {
const func = esc !== true ? escape : unescape
if (components.scheme !== undefined) {
components.scheme = func(components.scheme)
if (component.scheme !== undefined) {
component.scheme = func(component.scheme)
}
if (components.userinfo !== undefined) {
components.userinfo = func(components.userinfo)
if (component.userinfo !== undefined) {
component.userinfo = func(component.userinfo)
}
if (components.host !== undefined) {
components.host = func(components.host)
if (component.host !== undefined) {
component.host = func(component.host)
}
if (components.path !== undefined) {
components.path = func(components.path)
if (component.path !== undefined) {
component.path = func(component.path)
}
if (components.query !== undefined) {
components.query = func(components.query)
if (component.query !== undefined) {
component.query = func(component.query)
}
if (components.fragment !== undefined) {
components.fragment = func(components.fragment)
if (component.fragment !== undefined) {
component.fragment = func(component.fragment)
}
return components
return component
}
function recomposeAuthority (components, options) {
/**
* @param {import('../types/index').URIComponent} component
* @returns {string|undefined}
*/
function recomposeAuthority (component) {
const uriTokens = []
if (components.userinfo !== undefined) {
uriTokens.push(components.userinfo)
if (component.userinfo !== undefined) {
uriTokens.push(component.userinfo)
uriTokens.push('@')
}
if (components.host !== undefined) {
let host = unescape(components.host)
const ipV4res = normalizeIPv4(host)
if (ipV4res.isIPV4) {
host = ipV4res.host
} else {
const ipV6res = normalizeIPv6(ipV4res.host, { isIPV4: false })
if (component.host !== undefined) {
let host = unescape(component.host)
if (!isIPv4(host)) {
const ipV6res = normalizeIPv6(host)
if (ipV6res.isIPV6 === true) {
host = `[${ipV6res.escapedHost}]`
} else {
host = components.host
host = component.host
}
}
uriTokens.push(host)
}
if (typeof components.port === 'number' || typeof components.port === 'string') {
if (typeof component.port === 'number' || typeof component.port === 'string') {
uriTokens.push(':')
uriTokens.push(String(components.port))
uriTokens.push(String(component.port))
}
return uriTokens.length ? uriTokens.join('') : undefined
};
module.exports = {
nonSimpleDomain,
recomposeAuthority,
normalizeComponentEncoding,
removeDotSegments,
normalizeIPv4,
isIPv4,
isUUID,
normalizeIPv6,
stringToHexStripped
stringArrayToHexStripped
}