1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
import urlcat from '../src';
describe('urlcat', () => {
  it('Concatenates the base URL and the path if no params are passed', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com', 'path');    expect(actual).toBe(expected);  });
  it('Uses exactly one slash for joining even if the base URL has a trailing slash', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com/', 'path');    expect(actual).toBe(expected);  });
  it('Uses exactly one slash for joining even if the path has a leading slash', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com', '/path');    expect(actual).toBe(expected);  });
  it('Uses exactly one slash for joining even if the base URL and the path both have a slash at the boundary', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com/', '/path');    expect(actual).toBe(expected);  });
  it('Substitutes path parameters', () => {    const expected = 'http://example.com/path/1';    const actual = urlcat('http://example.com/', '/path/:p', { p: 1 });    expect(actual).toBe(expected);  });
  it('Allows path parameters at the beginning of the path', () => {    const expected = 'http://example.com/1';    const actual = urlcat('http://example.com/', ':p', { p: 1 });    expect(actual).toBe(expected);  });
  it('Parameters that are missing from the path become query parameters', () => {    const expected = 'http://example.com/path/1?q=2';    const actual = urlcat('http://example.com/', '/path/:p', { p: 1, q: 2 });    expect(actual).toBe(expected);  });
  it('Uses exactly one ? to join query parameters even if the path has a trailing question mark', () => {    const expected = 'http://example.com/path?q=2';    const actual = urlcat('http://example.com/', '/path?', { q: 2 });    expect(actual).toBe(expected);  });
  it('Removes trailing question mark from the path if no params are specified', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com/', '/path?', {});    expect(actual).toBe(expected);  });
  it('All parameters become query parameters if the path has no parameters', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com/', '/path?', {});    expect(actual).toBe(expected);  });
  it('If a parameter appears twice in the path, it is substituted twice', () => {    const expected = 'http://example.com/path/a/b/a/r';    const actual = urlcat('http://example.com/', '/path/:p1/:p2/:p1/r', { p1: 'a', p2: 'b' });    expect(actual).toBe(expected);  });
  it('Escapes both path and query parameters', () => {    const expected = 'http://example.com/path/a%20b?q=b+c';    const actual = urlcat('http://example.com/', '/path/:p', { p: 'a b', q: 'b c' });    expect(actual).toBe(expected);  });
  it('Can handle complex URL\'s', () => {    const expected = 'http://example.com/users/123/posts/987/comments?authorId=456&limit=10&offset=120';    const actual = urlcat(      'http://example.com/',      '/users/:userId/posts/:postId/comments',      { userId: 123, postId: 987, authorId: 456, limit: 10, offset: 120 }    );    expect(actual).toBe(expected);  });
  it('Provides an overload (baseUrl, pathTemplate) that works correctly', () => {    const expected = 'http://example.com/path';    const actual = urlcat('http://example.com/', '/path');    expect(actual).toBe(expected);  });
  it('Handles "//" path correctly (reproduces #7)', () => {    const expected = 'http://example.com//';    const actual = urlcat('http://example.com/', '//');    expect(actual).toBe(expected);  });
  it('Provides an overload (baseTemplate, params) that works correctly', () => {    const expected = 'http://example.com/path/a%20b?q=b+c';    const actual = urlcat('http://example.com/path/:p', { p: 'a b', q: 'b c' });    expect(actual).toBe(expected);  });
  it('Escape empty path params', () => {    const expected = 'http://example.com/path?p=a';    const actual = urlcat('http://example.com/path', '', { p: 'a' });    expect(actual).toBe(expected);  });
  it('Renders boolean (true) path params', () => {    const expected = 'http://example.com/path/true';    const actual = urlcat('http://example.com/path/:p', { p: true });    expect(actual).toBe(expected);  });
  it('Renders boolean (false) path params', () => {    const expected = 'http://example.com/path/false';    const actual = urlcat('http://example.com/path/:p', { p: false });    expect(actual).toBe(expected);  });
  it('Renders number path params', () => {    const expected = 'http://example.com/path/456';    const actual = urlcat('http://example.com/path/:p', { p: 456 });    expect(actual).toBe(expected);  });
  it('Renders string path params', () => {    const expected = 'http://example.com/path/test';    const actual = urlcat('http://example.com/path/:p', { p: 'test' });    expect(actual).toBe(expected);  });
  it('Ignores entirely numeric path params', () => {    const expected = 'http://localhost:3000/path/test';    const actual = urlcat('http://localhost:3000/path/:p', { p: 'test' });    expect(actual).toBe(expected);  });
  it('Throws if a path param is an object', () => {    expect(() => urlcat('http://example.com/path/:p', { p: {} }))      .toThrowError('Path parameter p cannot be of type object. Allowed types are: boolean, string, number.');  });
  it('Throws if a path param is an array', () => {    expect(() => urlcat('http://example.com/path/:p/:q', { p: [] }))      .toThrowError('Path parameter p cannot be of type object. Allowed types are: boolean, string, number.');  });
  it('Throws if a path param is a symbol', () => {    expect(() => urlcat('http://example.com/path/:p', { p: Symbol() }))      .toThrowError('Path parameter p cannot be of type symbol. Allowed types are: boolean, string, number.');  });
  it('Throws if a path param is undefined', () => {    expect(() => urlcat('http://example.com/path/:p', { p: undefined }))      .toThrowError('Path parameter p cannot be of type undefined. Allowed types are: boolean, string, number.');  });
  it('Throws if a path param is null', () => {    expect(() => urlcat('http://example.com/path/:p', { p: null }))      .toThrowError('Path parameter p cannot be of type object. Allowed types are: boolean, string, number.');  });
  it('Throws if a path param is an empty string', () => {    expect(() => urlcat('http://example.com/path/:p', { p: '' }))      .toThrowError('Path parameter p cannot be an empty string.');  });
  it('Throws if a path param contains only whitespace', () => {    expect(() => urlcat('http://example.com/path/:p', { p: '  ' }))      .toThrowError('Path parameter p cannot be an empty string.');  });
  it('Allows port numbers in path params', () => {    expect(urlcat('http://example.com:8080/path/:p', { p: 1 }))      .toBe('http://example.com:8080/path/1');  });
  it('Ignores path params which start with a number', () => {    expect(urlcat('http://example.com:8080/path/:1/:2/:p', { '1': 1, '2': 2, p: 3 }))      .toBe('http://example.com:8080/path/:1/:2/3?1=1&2=2');  });
  it('Does not replace both colons', () => {    expect(urlcat('http::one://example.com:8080/path/:one/:two/:three', { one: 1, two: 2, three: 3 }))      .toBe('http:1://example.com:8080/path/1/2/3');  });
});