fast-uri 4.1.2 → 4.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,6 +21,36 @@ test('URI Equals', (t) => {
21
21
  t.end()
22
22
  })
23
23
 
24
+ test('URI Equals rejects malformed object input even when identical', (t) => {
25
+ const malformed = { scheme: 'http', host: 'example.com', port: 99999, path: '/x' }
26
+ t.equal(fn(malformed, malformed), false)
27
+ t.end()
28
+ })
29
+
30
+ test('URI Equals preserves case-sensitive components', (t) => {
31
+ const suite = [
32
+ { pair: ['http://example.com/Admin', 'http://example.com/admin'], result: false },
33
+ { pair: ['http://example.com/?token=SECRET', 'http://example.com/?token=secret'], result: false },
34
+ { pair: ['http://example.com/#Section', 'http://example.com/#section'], result: false },
35
+ { pair: ['http://User@example.com/', 'http://user@example.com/'], result: false },
36
+ { pair: ['urn:foo:CaseSensitive', 'urn:foo:casesensitive'], result: false },
37
+ { pair: ['ws://example.com/Chat', 'ws://example.com/chat'], result: false },
38
+ { pair: ['ws://example.com/?token=SECRET', 'ws://example.com/?token=secret'], result: false },
39
+ { pair: [{ scheme: 'http', host: 'example.com', path: '/Admin' }, { scheme: 'http', host: 'example.com', path: '/admin' }], result: false }
40
+ ]
41
+ runTest(t, suite)
42
+ t.end()
43
+ })
44
+
45
+ test('URI Equals folds normalized scheme and host case', (t) => {
46
+ const suite = [
47
+ { pair: ['HTTP://EXAMPLE.COM/resource', 'http://example.com/resource'], result: true },
48
+ { pair: [{ scheme: 'HTTP', host: 'EXAMPLE.COM', path: '/resource' }, { scheme: 'http', host: 'example.com', path: '/resource' }], result: true }
49
+ ]
50
+ runTest(t, suite)
51
+ t.end()
52
+ })
53
+
24
54
  // test('IRI Equals', (t) => {
25
55
  // // example from RFC 3987
26
56
  // t.equal(URI.equal('example://a/b/c/%7Bfoo%7D/ros\xE9', 'eXAMPLE://a/./b/../b/%63/%7bfoo%7d/ros%C3%A9', IRI_OPTION), true)
@@ -66,9 +96,7 @@ test('URN Equals', (t) => {
66
96
 
67
97
  runTest(t, suite)
68
98
 
69
- t.throws(() => {
70
- fn('urn:', 'urn:FOO:a123,456')
71
- }, 'URN without nid cannot be serialized')
99
+ t.equal(fn('urn:', 'urn:FOO:a123,456'), false, 'malformed URN fails equality safely')
72
100
 
73
101
  t.end()
74
102
  })
@@ -107,6 +135,18 @@ test('WSS Equal', (t) => {
107
135
  t.end()
108
136
  })
109
137
 
138
+ test('Mailto Equal normalizes domains without folding message data', (t) => {
139
+ const suite = [
140
+ { pair: ['mailto:user@EXAMPLE.ORG', 'mailto:user@example.org'], result: true },
141
+ { pair: ['mailto:User@example.org', 'mailto:user@example.org'], result: false },
142
+ { pair: ['mailto:user@example.org?subject=Hello', 'mailto:user@example.org?subject=hello'], result: false },
143
+ { pair: ['mailto:user@example.org?body=Hello', 'mailto:user@example.org?body=hello'], result: false },
144
+ { pair: ['mailto:user@example.org?x=Hello', 'mailto:user@example.org?x=hello'], result: false }
145
+ ]
146
+ runTest(t, suite)
147
+ t.end()
148
+ })
149
+
110
150
  test('URI Equals tolerates malformed fragments', (t) => {
111
151
  t.equal(
112
152
  fastURI.equal('http://example.com/#%E0%A4A', 'http://example.com/#%E0%A4A'),
@@ -53,6 +53,7 @@
53
53
  "host": "[2001:dbz::1]",
54
54
  "port": 80,
55
55
  "path": "",
56
+ "error": "URI host is malformed.",
56
57
  "reference": "relative"
57
58
  }
58
59
  ],
@@ -242,6 +243,7 @@
242
243
  {
243
244
  "host": "[2606:2800:220:1:248:1893:25c8:1946:43209]",
244
245
  "path": "",
246
+ "error": "URI host is malformed.",
245
247
  "reference": "relative"
246
248
  }
247
249
  ],
@@ -497,5 +499,26 @@
497
499
  "subject": "Test",
498
500
  "body": "NATTO"
499
501
  }
502
+ ],
503
+ [
504
+ "mailto:addr1@an.example,addr2@an.example",
505
+ {
506
+ "scheme": "mailto",
507
+ "reference": "absolute",
508
+ "to": [
509
+ "addr1@an.example",
510
+ "addr2@an.example"
511
+ ]
512
+ }
513
+ ],
514
+ [
515
+ "mailto:user@example.org?",
516
+ {
517
+ "scheme": "mailto",
518
+ "reference": "absolute",
519
+ "to": [
520
+ "user@example.org"
521
+ ]
522
+ }
500
523
  ]
501
- ]
524
+ ]
@@ -116,5 +116,27 @@
116
116
  "path": "with:colon"
117
117
  },
118
118
  "scheme:with:colon"
119
+ ],
120
+ [
121
+ {
122
+ "scheme": "mailto",
123
+ "to": [
124
+ "chris@example.com"
125
+ ]
126
+ },
127
+ "mailto:chris@example.com"
128
+ ],
129
+ [
130
+ {
131
+ "scheme": "mailto",
132
+ "to": [
133
+ "joe@example.com"
134
+ ],
135
+ "headers": {
136
+ "cc": "bob@example.com"
137
+ },
138
+ "body": "hello"
139
+ },
140
+ "mailto:joe@example.com?cc=bob@example.com&body=hello"
119
141
  ]
120
- ]
142
+ ]
@@ -0,0 +1,34 @@
1
+ 'use strict'
2
+
3
+ const test = require('tape')
4
+ const fastURI = require('..')
5
+
6
+ test('IPv6 hosts normalize to the RFC 5952 canonical form', (t) => {
7
+ const cases = [
8
+ ['http://[0:0:0:0:0:0:0:1]/', 'http://[::1]/'],
9
+ ['http://[0:0:0:0:0:0:0:0]/', 'http://[::]/'],
10
+ ['http://[2001:0db8:0000:0000:0000:0000:0000:0001]/', 'http://[2001:db8::1]/'],
11
+ ['http://[2001:0:0:0:0:0:0:1]/', 'http://[2001::1]/'],
12
+ ['http://[fe80:0:0:0:0:0:0:1]/', 'http://[fe80::1]/'],
13
+ ['http://[1:0:0:0:2:0:0:3]/', 'http://[1::2:0:0:3]/']
14
+ ]
15
+
16
+ for (const [uri, normalized] of cases) {
17
+ t.equal(fastURI.normalize(uri), normalized, `${uri} normalizes to ${normalized}`)
18
+ }
19
+ t.end()
20
+ })
21
+
22
+ test('IPv6 equal() matches the same address across compressed and expanded forms', (t) => {
23
+ const pairs = [
24
+ ['http://[::1]/', 'http://[0:0:0:0:0:0:0:1]/'],
25
+ ['http://[::]/', 'http://[0:0:0:0:0:0:0:0]/'],
26
+ ['http://[2001:db8::1]/', 'http://[2001:0db8:0000:0000:0000:0000:0000:0001]/'],
27
+ ['http://[1::2:0:0:3]/', 'http://[1:0:0:0:2:0:0:3]/']
28
+ ]
29
+
30
+ for (const [a, b] of pairs) {
31
+ t.equal(fastURI.equal(a, b), true, `${a} equals ${b}`)
32
+ }
33
+ t.end()
34
+ })
@@ -0,0 +1,154 @@
1
+ 'use strict'
2
+
3
+ const test = require('tape')
4
+ const fastURI = require('..')
5
+
6
+ const HOST_ERROR = 'URI host is malformed.'
7
+
8
+ const malformedLiterals = [
9
+ '::not-valid',
10
+ 'fc00::not-hex',
11
+ 'fe80::not-hex',
12
+ '1:2:3',
13
+ '1:2:3:4:5:6:7',
14
+ '1:2:3:4:5:6:7:8:9',
15
+ '1::2::3',
16
+ '1:::2',
17
+ ':::1',
18
+ '12345::',
19
+ '1:2:3:4:5:6:7::8',
20
+ '::ffff:192.0.2.999',
21
+ '::ffff:192.0.2',
22
+ '::ffff:192.168.001.1',
23
+ '::192.0.2.1:1',
24
+ '1:2:3:4:5:192.0.2.1::',
25
+ 'v.foo',
26
+ 'v1.',
27
+ 'v1.foo%25bar',
28
+ 'v1.K',
29
+ 'fe80::1%25',
30
+ 'fe80::1%25eth 0',
31
+ 'fe80::1%25eth%ZZ',
32
+ 'fe80::1%25K',
33
+ 'not-an-ip'
34
+ ]
35
+
36
+ test('malformed bracketed IP literals fail without being rewritten', (t) => {
37
+ for (const literal of malformedLiterals) {
38
+ const uri = `http://[${literal}]/private`
39
+ const parsed = fastURI.parse(uri)
40
+
41
+ t.equal(parsed.error, HOST_ERROR, `parse rejects ${literal}`)
42
+ t.equal(parsed.host, `[${literal.toLowerCase()}]`, `parse does not truncate ${literal}`)
43
+ t.equal(fastURI.normalize(uri), uri, `normalize preserves ${literal}`)
44
+ t.equal(fastURI.equal(uri, uri), false, `equal rejects ${literal}`)
45
+ }
46
+ t.end()
47
+ })
48
+
49
+ test('resolve throws for malformed bracketed IP literals', (t) => {
50
+ for (const literal of malformedLiterals) {
51
+ const uri = `http://[${literal}]/private`
52
+
53
+ t.throws(
54
+ () => fastURI.resolve(uri, 'child'),
55
+ /URI host is malformed\./,
56
+ `rejects malformed base ${literal}`
57
+ )
58
+ t.throws(
59
+ () => fastURI.resolve('http://example.com/', uri),
60
+ /URI host is malformed\./,
61
+ `rejects malformed relative input ${literal}`
62
+ )
63
+ }
64
+ t.end()
65
+ })
66
+
67
+ test('valid IPv6, IPvFuture, embedded IPv4, and zone forms normalize safely', (t) => {
68
+ const cases = [
69
+ ['http://[::]/', 'http://[::]/', '::'],
70
+ ['http://[::1]/', 'http://[::1]/', '::1'],
71
+ ['http://[1::]/', 'http://[1::]/', '1::'],
72
+ ['http://[2001:0DB8::0001]/', 'http://[2001:db8::1]/', '2001:db8::1'],
73
+ ['http://[0:0:0:0:0:0:0:0]/', 'http://[::]/', '::'],
74
+ ['http://[::ffff:192.0.2.1]/', 'http://[::ffff:192.0.2.1]/', '::ffff:192.0.2.1'],
75
+ ['http://[1:2:3:4:5:6:192.0.2.1]/', 'http://[1:2:3:4:5:6:192.0.2.1]/', '1:2:3:4:5:6:192.0.2.1'],
76
+ ['http://[fe80::A%25EN1]/', 'http://[fe80::a%25EN1]/', 'fe80::a%EN1'],
77
+ ['http://[fe80::a%en1]/', 'http://[fe80::a%25en1]/', 'fe80::a%en1'],
78
+ ['http://[fe80::a%25eth%2D0]/', 'http://[fe80::a%25eth%2D0]/', 'fe80::a%eth%2D0'],
79
+ ['http://[v1.example]/', 'http://[v1.example]/', '[v1.example]'],
80
+ ['http://[vF.A:b]/', 'http://[vf.a:b]/', '[vf.a:b]']
81
+ ]
82
+
83
+ for (const [uri, normalized, host] of cases) {
84
+ const parsed = fastURI.parse(uri)
85
+ t.equal(parsed.error, undefined, `${uri} parses without error`)
86
+ t.equal(parsed.host, host, `${uri} has the expected host`)
87
+ t.equal(fastURI.normalize(uri), normalized, `${uri} normalizes safely`)
88
+ }
89
+ t.end()
90
+ })
91
+
92
+ test('IPv6 zone identifiers are validated correctly', (t) => {
93
+ const valid = [
94
+ 'http://[fe80::1%25eth0]/',
95
+ 'http://[fe80::a%en1]/',
96
+ 'http://[fe80::a%25eth%2D0]/'
97
+ ]
98
+
99
+ for (const uri of valid) {
100
+ const parsed = fastURI.parse(uri)
101
+
102
+ t.equal(parsed.error, undefined, `${uri} parses without error`)
103
+ }
104
+
105
+ const malformed = [
106
+ 'http://[fe80::1%25]/',
107
+ 'http://[fe80::1%25eth 0]/',
108
+ 'http://[fe80::1%25eth%ZZ]/',
109
+ 'http://[fe80::1%25K]/'
110
+ ]
111
+
112
+ for (const uri of malformed) {
113
+ const parsed = fastURI.parse(uri)
114
+
115
+ t.equal(parsed.error, HOST_ERROR, `${uri} is rejected`)
116
+ t.equal(fastURI.normalize(uri), uri, `${uri} is not rewritten`)
117
+ t.equal(fastURI.equal(uri, uri), false, `${uri} is not comparable`)
118
+ }
119
+ t.end()
120
+ })
121
+
122
+ test('hosts with unbalanced or misplaced IP-literal brackets are rejected', (t) => {
123
+ const malformed = [
124
+ 'http://[fe80',
125
+ 'http://[',
126
+ 'http://[not-an-ip',
127
+ 'http://[\u65e5\u672c',
128
+ 'http://user@[@127.0.0.1:8123/admin',
129
+ 'http://user@]127.0.0.1:8123/admin',
130
+ 'http://user@prefix[@127.0.0.1:8123/admin',
131
+ 'http://user@prefix]@127.0.0.1:8123/admin'
132
+ ]
133
+ const modes = [
134
+ ['default', undefined],
135
+ ['Unicode', { unicodeSupport: true }]
136
+ ]
137
+
138
+ for (const [mode, options] of modes) {
139
+ for (const uri of malformed) {
140
+ const parsed = fastURI.parse(uri, options)
141
+ const message = `${mode} mode rejects ${uri}`
142
+
143
+ t.equal(parsed.error, HOST_ERROR, `parse ${message}`)
144
+ t.equal(fastURI.normalize(uri, options), uri, `normalize preserves ${uri} in ${mode} mode`)
145
+ t.equal(fastURI.equal(uri, uri, options), false, `equal ${message}`)
146
+ t.throws(
147
+ () => fastURI.resolve('http://example.com/', uri, options),
148
+ /URI host is malformed\./,
149
+ `resolve ${message}`
150
+ )
151
+ }
152
+ }
153
+ t.end()
154
+ })
@@ -0,0 +1,77 @@
1
+ 'use strict'
2
+
3
+ const test = require('tape')
4
+ const fastURI = require('..')
5
+
6
+ const MALFORMED_PERCENT_ERROR = 'URI contains malformed percent-encoding.'
7
+
8
+ const malformedComponents = [
9
+ ['path', 'x://example.test/a%'],
10
+ ['path with one trailing hex digit', 'x://example.test/a%2'],
11
+ ['path with non-hex digits', 'x://example.test/a%GG'],
12
+ ['host', 'x://exa%mple.test/path'],
13
+ ['userinfo', 'x://us%er@example.test/path'],
14
+ ['query', 'x://example.test/path?q=%G0'],
15
+ ['fragment', 'x://example.test/path#frag%1']
16
+ ]
17
+
18
+ test('parse reports malformed percent syntax in generic URI components', (t) => {
19
+ for (const [component, uri] of malformedComponents) {
20
+ t.equal(fastURI.parse(uri).error, MALFORMED_PERCENT_ERROR, component)
21
+ }
22
+ t.end()
23
+ })
24
+
25
+ test('normalize preserves malformed percent input unchanged', (t) => {
26
+ for (const [component, uri] of malformedComponents) {
27
+ t.equal(fastURI.normalize(uri), uri, component)
28
+ }
29
+ t.end()
30
+ })
31
+
32
+ test('equal does not equate malformed input with repaired valid input', (t) => {
33
+ const cases = [
34
+ ['x://example.test/a%', 'x://example.test/a%25'],
35
+ ['x://exa%mple.test/path', 'x://exa%25mple.test/path'],
36
+ ['x://us%er@example.test/path', 'x://us%25er@example.test/path'],
37
+ ['x://example.test/path?q=%', 'x://example.test/path?q=%25'],
38
+ ['x://example.test/path#%', 'x://example.test/path#%25']
39
+ ]
40
+
41
+ for (const [malformed, repaired] of cases) {
42
+ t.equal(fastURI.equal(malformed, repaired, {}), false, malformed)
43
+ }
44
+ t.end()
45
+ })
46
+
47
+ test('resolve rejects malformed percent syntax in either input', (t) => {
48
+ t.throws(
49
+ () => fastURI.resolve('x://example.test/base%', 'child'),
50
+ /URI contains malformed percent-encoding\./,
51
+ 'malformed base'
52
+ )
53
+ t.throws(
54
+ () => fastURI.resolve('x://example.test/base', 'child%'),
55
+ /URI contains malformed percent-encoding\./,
56
+ 'malformed relative reference'
57
+ )
58
+ t.end()
59
+ })
60
+
61
+ test('valid percent octets remain valid without UTF-8 validation', (t) => {
62
+ const uri = '/%ff?q=%80#%fe'
63
+ const parsed = fastURI.parse(uri)
64
+
65
+ t.equal(parsed.error, undefined, 'non-UTF-8 octets are valid percent syntax')
66
+ t.equal(parsed.path, '/%FF', 'path octet is preserved and hex is uppercased')
67
+ t.equal(parsed.query, 'q=%80', 'query octet is preserved')
68
+ t.equal(parsed.fragment, '%FE', 'fragment octet is preserved and hex is uppercased')
69
+ t.equal(fastURI.normalize(uri), '/%FF?q=%80#%FE', 'normalization preserves the octets')
70
+
71
+ const allGenericComponents = fastURI.parse('x://u%2f@exa%2fmple.test/%2f?q=%2f#%2f')
72
+ t.equal(allGenericComponents.error, undefined, 'valid escapes are accepted in every generic component')
73
+
74
+ const ipv6Zone = fastURI.parse('//[2001:db8::7%en0]')
75
+ t.equal(ipv6Zone.error, undefined, 'historically accepted raw IPv6 zone separator is unchanged')
76
+ t.end()
77
+ })
@@ -0,0 +1,61 @@
1
+ 'use strict'
2
+
3
+ const test = require('tape')
4
+ const fastURI = require('..')
5
+
6
+ const malformedURNs = [
7
+ 'urn:',
8
+ 'URN:',
9
+ 'urn:foo',
10
+ 'urn::foo',
11
+ 'urn:foo:',
12
+ 'urn:%66oo:bar'
13
+ ]
14
+
15
+ test('parse reports malformed ordinary URNs', (t) => {
16
+ for (const uri of malformedURNs) {
17
+ t.match(fastURI.parse(uri).error, /^URN can not be parsed\.?$/, uri)
18
+ }
19
+ t.end()
20
+ })
21
+
22
+ test('normalize preserves malformed ordinary URNs without throwing', (t) => {
23
+ for (const uri of malformedURNs) {
24
+ t.doesNotThrow(() => fastURI.normalize(uri), `${uri} does not throw`)
25
+ t.equal(fastURI.normalize(uri), uri, `${uri} is preserved`)
26
+ }
27
+ t.equal(
28
+ fastURI.normalize('urn:foo', { reference: 'relative' }),
29
+ 'urn:foo',
30
+ 'an earlier parse error does not hide the missing URN nid'
31
+ )
32
+ t.end()
33
+ })
34
+
35
+ test('equal returns false for malformed ordinary URNs', (t) => {
36
+ for (const uri of malformedURNs) {
37
+ t.equal(fastURI.equal(uri, uri, {}), false, `${uri} is not equal to itself as malformed input`)
38
+ t.equal(fastURI.equal(uri, 'urn:foo:bar', {}), false, `${uri} is not equal to a valid URN`)
39
+ }
40
+ t.end()
41
+ })
42
+
43
+ test('resolve handles malformed ordinary URNs without throwing', (t) => {
44
+ for (const uri of malformedURNs) {
45
+ t.doesNotThrow(() => fastURI.resolve('uri://base/', uri), `${uri} does not throw as a relative reference`)
46
+ t.doesNotThrow(() => fastURI.resolve(uri, ''), `${uri} does not throw as a base URI`)
47
+ }
48
+ // resolve preserves the malformed scheme-specific input rather than surfacing
49
+ // an uncaught 'URN without nid cannot be serialized' error (matches upstream uri-js)
50
+ t.equal(fastURI.resolve('uri://base/', 'urn:'), 'urn:', 'malformed relative URN is preserved')
51
+ t.equal(fastURI.resolve('URN:', ''), 'urn:', 'scheme case is normalized')
52
+ t.equal(fastURI.resolve('uri://base/', 'urn:%66oo:bar'), 'urn:foo:bar', 'percent-encoding is decoded')
53
+ t.end()
54
+ })
55
+
56
+ test('valid URNs retain their existing behavior', (t) => {
57
+ t.equal(fastURI.normalize('URN:FOO:a123,456'), 'urn:foo:a123,456')
58
+ t.equal(fastURI.equal('urn:foo:a123,456', 'URN:FOO:a123,456', {}), true)
59
+ t.equal(fastURI.resolve('uri://base/', 'urn:'), 'urn:', 'default resolve behavior is unchanged')
60
+ t.end()
61
+ })
@@ -214,6 +214,7 @@ test('URI parse', (t) => {
214
214
  // invalid IPv6
215
215
  components = fastURI.parse('//[2001:dbZ::7]')
216
216
  t.equal(components.host, '[2001:dbz::7]')
217
+ t.equal(components.error, 'URI host is malformed.')
217
218
 
218
219
  // mixed IPv4address & IPv6address
219
220
  components = fastURI.parse('//[::ffff:129.144.52.38]')
@@ -318,8 +319,152 @@ test('URI parse', (t) => {
318
319
 
319
320
  components = fastURI.parse('//[2606:2800:220:1:248:1893:25c8:1946:43209]')
320
321
  t.equal(components.host, '[2606:2800:220:1:248:1893:25c8:1946:43209]')
322
+ t.equal(components.error, 'URI host is malformed.')
321
323
 
322
324
  components = fastURI.parse('urn:foo:|\\24fpl')
323
325
  t.equal(components.error, 'URN can not be parsed.')
324
326
  t.end()
325
327
  })
328
+
329
+ test('Mailto parsing normalizes Unicode domains according to options', (t) => {
330
+ t.deepEqual(
331
+ fastURI.parse('mailto:user@納豆.example.org').to,
332
+ ['user@xn--99zt52a.example.org'],
333
+ 'Unicode domain defaults to ASCII'
334
+ )
335
+ t.deepEqual(
336
+ fastURI.parse('mailto:user@納豆.example.org', { unicodeSupport: true }).to,
337
+ ['user@納豆.example.org'],
338
+ 'Unicode domain is preserved when requested'
339
+ )
340
+ t.deepEqual(
341
+ fastURI.parse('mailto:user@xn--99zt52a.example.org', { unicodeSupport: true }).to,
342
+ ['user@xn--99zt52a.example.org'],
343
+ 'existing punycode remains unchanged in Unicode mode'
344
+ )
345
+ t.end()
346
+ })
347
+
348
+ test('Mailto parsing preserves and reports malformed recipient domains', (t) => {
349
+ const cases = [
350
+ ['mailto:user@example.org:25', 'user@example.org:25'],
351
+ ['mailto:user@example.org/path', 'user@example.org/path'],
352
+ ['mailto:user@example.org%40evil.test', 'user@example.org@evil.test'],
353
+ ['mailto:user@example.org%3Fquery', 'user@example.org?query'],
354
+ ['mailto:user@example.org%23fragment', 'user@example.org#fragment'],
355
+ ['mailto:user@[broken', 'user@[broken'],
356
+ ['mailto:user', 'user']
357
+ ]
358
+
359
+ for (const [uri, recipient] of cases) {
360
+ const parsed = fastURI.parse(uri)
361
+ t.equal(parsed.error, 'URI mailto has an invalid recipient domain.', 'error for ' + uri)
362
+ t.deepEqual(parsed.to, [recipient], 'recipient is preserved for ' + uri)
363
+ }
364
+ t.end()
365
+ })
366
+
367
+ test('Mailto parsing handles domain literals, empty queries, and malformed headers', (t) => {
368
+ const literal = fastURI.parse('mailto:user@[IPv6:2001:db8::1]')
369
+ t.equal(literal.error, undefined, 'valid domain literal has no error')
370
+ t.deepEqual(literal.to, ['user@[ipv6:2001:db8::1]'], 'domain literal is preserved')
371
+
372
+ const emptyQuery = fastURI.parse('mailto:user@example.org?')
373
+ t.equal(emptyQuery.query, undefined, 'empty query is cleared')
374
+ t.equal(emptyQuery.headers, undefined, 'empty query does not create a header')
375
+
376
+ const malformedHeaders = fastURI.parse('mailto:joe@example.com?cc=bob@example.com?body=hello')
377
+ t.equal(malformedHeaders.error, 'URI mailto has malformed header fields.', 'malformed fields set an error')
378
+ t.deepEqual(malformedHeaders.to, ['joe@example.com'], 'path recipient is retained')
379
+ t.end()
380
+ })
381
+
382
+ test('Mailto parsing folds lone surrogates in raw input', (t) => {
383
+ // The handler sets `skipNormalize`, so it must fold lone surrogates itself --
384
+ // the generic query/path normalizers no longer run to do it.
385
+ const lone = '\uD800'
386
+ const trailing = '\uDC00'
387
+
388
+ t.deepEqual(
389
+ // spread: `headers` has a null prototype, which t.deepEqual compares strictly
390
+ { ...fastURI.parse('mailto:a@b.test?x=' + lone).headers },
391
+ { x: '�' },
392
+ 'lone high surrogate in a header value becomes U+FFFD'
393
+ )
394
+ t.equal(
395
+ fastURI.parse('mailto:a@b.test?subject=' + trailing).subject,
396
+ '�',
397
+ 'lone low surrogate in a subject becomes U+FFFD'
398
+ )
399
+ t.deepEqual(
400
+ fastURI.parse('mailto:' + lone + '@b.test').to,
401
+ ['�@b.test'],
402
+ 'lone surrogate in a local part becomes U+FFFD'
403
+ )
404
+ t.deepEqual(
405
+ fastURI.parse('mailto:a@b.test?subject=😀').subject,
406
+ '😀',
407
+ 'a valid surrogate pair is left intact'
408
+ )
409
+ t.end()
410
+ })
411
+
412
+ test('Mailto domain fast path agrees with the WHATWG parser', (t) => {
413
+ // `mailtoNormalizeDomain` skips `new URL` when `nonSimpleMailtoDomain` is
414
+ // false. Every domain here must come out the same either way -- especially the
415
+ // all-numeric last labels, which `new URL` reads as IPv4 shorthand.
416
+ const domains = [
417
+ 'example.com',
418
+ 'example.org',
419
+ 'mail2.example.org',
420
+ 's3.amazonaws.com',
421
+ 'ex4mple.com',
422
+ '_dmarc.example.com',
423
+ '-a.com',
424
+ 'a..b',
425
+ 'a.com.',
426
+ '1.2.3',
427
+ '127.1',
428
+ '12',
429
+ '0x7f.1',
430
+ '9.9.9.9',
431
+ '1.2.3.4'
432
+ ]
433
+
434
+ for (const domain of domains) {
435
+ const parsed = fastURI.parse('mailto:user@' + domain)
436
+ let expected
437
+ try {
438
+ const url = new URL('http://' + domain)
439
+ const invalid = url.username || url.password || url.port ||
440
+ url.pathname !== '/' || url.search || url.hash || !url.hostname
441
+ expected = invalid ? domain : url.hostname
442
+ } catch {
443
+ expected = domain
444
+ }
445
+ t.deepEqual(parsed.to, ['user@' + expected], 'matches new URL for ' + domain)
446
+ }
447
+
448
+ // The fast path must not be taken for a domain whose last label is numeric.
449
+ t.deepEqual(fastURI.parse('mailto:user@1.2.3').to, ['user@1.2.0.3'], 'IPv4 shorthand is still applied')
450
+ t.deepEqual(fastURI.parse('mailto:user@mail2.example.org').to, ['user@mail2.example.org'], 'digits stay on the fast path')
451
+ t.end()
452
+ })
453
+
454
+ test('Mailto headers use a null prototype', (t) => {
455
+ // Header names come from untrusted input, so a lookup must not resolve to an
456
+ // inherited member of Object.prototype.
457
+ const parsed = fastURI.parse('mailto:a@b.test?blat=foop')
458
+ t.equal(Object.getPrototypeOf(parsed.headers), null, 'headers has no prototype')
459
+ t.equal(parsed.headers.toString, undefined, 'inherited members do not leak')
460
+ t.equal(parsed.headers.constructor, undefined, 'constructor does not leak')
461
+
462
+ // With a null prototype "__proto__" is an ordinary key rather than a setter,
463
+ // so it round-trips instead of being silently discarded.
464
+ const polluted = fastURI.parse('mailto:a@b.test?__proto__=x')
465
+ t.deepEqual(Object.keys(polluted.headers), ['__proto__'], '__proto__ is kept as an own key')
466
+ t.equal(fastURI.serialize(polluted), 'mailto:a@b.test?__proto__=x', '__proto__ round-trips')
467
+ t.equal({}.x, undefined, 'Object.prototype is not polluted')
468
+ t.equal(Object.getPrototypeOf({}), Object.prototype, 'Object.prototype is intact')
469
+ t.end()
470
+ })