Skip to content

Commit d347f33

Browse files
committed
path: update win32 toNamespacedPath to support device namespace paths
1 parent 880c446 commit d347f33

File tree

2 files changed

+58
-0
lines changed

2 files changed

+58
-0
lines changed

lib/path.js

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,25 @@ function glob(path, pattern, windows) {
180180
});
181181
}
182182

183+
// Regular expressions to identify special device names in Windows.
184+
// Ref: https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilea
185+
// COM to AUX (e.g., COM1, LPT1, NUL, CON, PRN, AUX) are reserved OS device names.
186+
// Paths like C:\path\to\COM1 map to \\.\COM1, referencing hardware or system streams.
187+
// Ref: https://learn.microsoft.com/en-us/windows/win32/fileio/naming-a-file#maximum-path-length-limitation
188+
const windowDevicePatterns = [
189+
/([\\/])?(COM\d+)$/i,
190+
/([\\/])?(LPT\d+)$/i,
191+
/([\\/])?(NUL)$/i,
192+
/([\\/])?(CON)$/i,
193+
/([\\/])?(PRN)$/i,
194+
/([\\/])?(AUX)$/i,
195+
/^(PHYSICALDRIVE\d+)$/i,
196+
/^(PIPE\\.+)$/i,
197+
/^(MAILSLOT\\.+)$/i,
198+
/^(TAPE\d+)$/i,
199+
/^(CHANGER\d+)$/i,
200+
];
201+
183202
const win32 = {
184203
/**
185204
* path.resolve([from ...], to)
@@ -687,6 +706,19 @@ const win32 = {
687706
if (typeof path !== 'string' || path.length === 0)
688707
return path;
689708

709+
// Check if the path matches any device pattern
710+
if (windowDevicePatterns.some((pattern) => pattern.test(path))) {
711+
let deviceName;
712+
if (/^(PIPE\\.+)$/i.test(path) || /^(MAILSLOT\\.+)$/i.test(path)) {
713+
// If the path starts with PIPE\ or MAILSLOT\, keep it as is
714+
deviceName = path;
715+
} else {
716+
// Extract the last component after the last slash or backslash
717+
deviceName = path.split(/[\\/]/).pop();
718+
}
719+
return `\\\\.\\${deviceName}`;
720+
}
721+
690722
const resolvedPath = win32.resolve(path);
691723

692724
if (resolvedPath.length <= 2)

test/parallel/test-path-makelong.js

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,34 @@ if (common.isWindows) {
3939
assert.strictEqual(path.toNamespacedPath(
4040
'\\\\?\\UNC\\someserver\\someshare\\somefile'),
4141
'\\\\?\\UNC\\someserver\\someshare\\somefile');
42+
// Device name tests
43+
assert.strictEqual(path.toNamespacedPath('C:\\path\\COM1'),
44+
'\\\\.\\COM1');
45+
assert.strictEqual(path.toNamespacedPath('COM1'),
46+
'\\\\.\\COM1');
47+
assert.strictEqual(path.toNamespacedPath('LPT1'),
48+
'\\\\.\\LPT1');
49+
assert.strictEqual(path.toNamespacedPath('C:\\LPT1'),
50+
'\\\\.\\LPT1');
51+
assert.strictEqual(path.toNamespacedPath('PhysicalDrive0'),
52+
'\\\\.\\PhysicalDrive0');
53+
assert.strictEqual(path.toNamespacedPath('pipe\\mypipe'),
54+
'\\\\.\\pipe\\mypipe');
55+
assert.strictEqual(path.toNamespacedPath('MAILSLOT\\mySlot'),
56+
'\\\\.\\MAILSLOT\\mySlot');
57+
assert.strictEqual(path.toNamespacedPath('NUL'),
58+
'\\\\.\\NUL');
59+
assert.strictEqual(path.toNamespacedPath('Tape0'),
60+
'\\\\.\\Tape0');
61+
assert.strictEqual(path.toNamespacedPath('Changer0'),
62+
'\\\\.\\Changer0');
63+
// Test cases for inputs with "\\.\" prefix
4264
assert.strictEqual(path.toNamespacedPath('\\\\.\\pipe\\somepipe'),
4365
'\\\\.\\pipe\\somepipe');
66+
assert.strictEqual(path.toNamespacedPath('\\\\.\\COM1'),
67+
'\\\\.\\COM1');
68+
assert.strictEqual(path.toNamespacedPath('\\\\.\\LPT1'),
69+
'\\\\.\\LPT1');
4470
}
4571

4672
assert.strictEqual(path.toNamespacedPath(''), '');

0 commit comments

Comments
 (0)