deno.land / std@0.224.0 / path / windows / resolve.ts

resolve.ts
View Documentation
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
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.// This module is browser compatible.
import { CHAR_COLON } from "../_common/constants.ts";import { normalizeString } from "../_common/normalize_string.ts";import { assertPath } from "../_common/assert_path.ts";import { isPathSeparator, isWindowsDeviceRoot } from "./_util.ts";
/** * Resolves path segments into a `path` * @param pathSegments to process to path */export function resolve(...pathSegments: string[]): string { let resolvedDevice = ""; let resolvedTail = ""; let resolvedAbsolute = false;
for (let i = pathSegments.length - 1; i >= -1; i--) { let path: string; // deno-lint-ignore no-explicit-any const { Deno } = globalThis as any; if (i >= 0) { path = pathSegments[i]!; } else if (!resolvedDevice) { if (typeof Deno?.cwd !== "function") { throw new TypeError("Resolved a drive-letter-less path without a CWD."); } path = Deno.cwd(); } else { if ( typeof Deno?.env?.get !== "function" || typeof Deno?.cwd !== "function" ) { throw new TypeError("Resolved a relative path without a CWD."); } path = Deno.cwd();
// Verify that a cwd was found and that it actually points // to our drive. If not, default to the drive's root. if ( path === undefined || path.slice(0, 3).toLowerCase() !== `${resolvedDevice.toLowerCase()}\\` ) { path = `${resolvedDevice}\\`; } }
assertPath(path);
const len = path.length;
// Skip empty entries if (len === 0) continue;
let rootEnd = 0; let device = ""; let isAbsolute = false; const code = path.charCodeAt(0);
// Try to match a root if (len > 1) { if (isPathSeparator(code)) { // Possible UNC root
// If we started with a separator, we know we at least have an // absolute path of some kind (UNC or otherwise) isAbsolute = true;
if (isPathSeparator(path.charCodeAt(1))) { // Matched double path separator at beginning let j = 2; let last = j; // Match 1 or more non-path separators for (; j < len; ++j) { if (isPathSeparator(path.charCodeAt(j))) break; } if (j < len && j !== last) { const firstPart = path.slice(last, j); // Matched! last = j; // Match 1 or more path separators for (; j < len; ++j) { if (!isPathSeparator(path.charCodeAt(j))) break; } if (j < len && j !== last) { // Matched! last = j; // Match 1 or more non-path separators for (; j < len; ++j) { if (isPathSeparator(path.charCodeAt(j))) break; } if (j === len) { // We matched a UNC root only device = `\\\\${firstPart}\\${path.slice(last)}`; rootEnd = j; } else if (j !== last) { // We matched a UNC root with leftovers
device = `\\\\${firstPart}\\${path.slice(last, j)}`; rootEnd = j; } } } } else { rootEnd = 1; } } else if (isWindowsDeviceRoot(code)) { // Possible device root
if (path.charCodeAt(1) === CHAR_COLON) { device = path.slice(0, 2); rootEnd = 2; if (len > 2) { if (isPathSeparator(path.charCodeAt(2))) { // Treat separator following drive name as an absolute path // indicator isAbsolute = true; rootEnd = 3; } } } } } else if (isPathSeparator(code)) { // `path` contains just a path separator rootEnd = 1; isAbsolute = true; }
if ( device.length > 0 && resolvedDevice.length > 0 && device.toLowerCase() !== resolvedDevice.toLowerCase() ) { // This path points to another device so it is not applicable continue; }
if (resolvedDevice.length === 0 && device.length > 0) { resolvedDevice = device; } if (!resolvedAbsolute) { resolvedTail = `${path.slice(rootEnd)}\\${resolvedTail}`; resolvedAbsolute = isAbsolute; }
if (resolvedAbsolute && resolvedDevice.length > 0) break; }
// At this point the path should be resolved to a full absolute path, // but handle relative paths to be safe (might happen when Deno.cwd() // fails)
// Normalize the tail path resolvedTail = normalizeString( resolvedTail, !resolvedAbsolute, "\\", isPathSeparator, );
return resolvedDevice + (resolvedAbsolute ? "\\" : "") + resolvedTail || ".";}
std

Version Info

Tagged at
6 months ago