path

Модуль node:path предоставляет утилиты для работы с путями к файлам и каталогам. Доступ к нему можно получить с помощью:

import path from 'node:path';

Использование в Deno

import * as mod from "node:path";

интерфейс default.FormatInputPathObject

Использование в Deno

import mod from "node:path";

Свойства

root: string | undefined

необязательный

Корень пути, например '/' или 'c:'

dir: string | undefined

необязательный

Полный путь к каталогу, например '/home/user/dir' или 'c:\path\dir'

base: string | undefined

необязательный

Имя файла вместе с расширением (если оно есть), например 'index.html'

ext: string | undefined

необязательный

Расширение файла (если оно есть), например '.html'

name: string | undefined

необязательный

Имя файла без расширения (если оно есть), например 'index'

интерфейс default.ParsedPath

Использование в Deno

import mod from "node:path";

Объект с разобранным путём, созданный функцией path.parse() или используемый функцией path.format().

Свойства

root: string

Корень пути, например '/' или 'c:'

dir: string

Полный путь к каталогу, например '/home/user/dir' или 'c:\path\dir'

base: string

Имя файла вместе с расширением (если оно есть), например 'index.html'

ext: string

Расширение файла (если оно есть), например '.html'

name: string

Имя файла без расширения (если оно есть), например 'index'

интерфейс default.PlatformPath

Использование в Deno

import mod from "node:path";

Свойства

sep: "\\" | "/"

только для чтения

Разделитель файловых путей, зависящий от платформы: '\' или '/'.

delimiter: ";" | ":"

только для чтения

Разделитель файлов, зависящий от платформы: ';' или ':'.

posix: PlatformPath

только для чтения

Обработка путей для POSIX. В POSIX соответствует родительскому объекту.

win32: PlatformPath

только для чтения

Обработка путей для Windows. В Windows соответствует родительскому объекту.

Методы

normalize(path: string): string

Нормализует строковый путь, сокращая его компоненты '..' и '.'. Если обнаружено несколько косых черт, они заменяются одной; если путь заканчивается косой чертой, она сохраняется. В Windows используются обратные косые черты.

join(...paths: string[]): string

Объединяет все аргументы и нормализует полученный путь.

resolve(...paths: string[]): string

Крайний правый параметр считается {to}. Остальные параметры считаются массивом {from}.

Начиная с самого левого параметра {from}, преобразует {to} в абсолютный путь.

Если {to} ещё не является абсолютным, аргументы {from} добавляются перед ним справа налево, пока не будет найден абсолютный путь. Если после использования всех путей {from} абсолютный путь так и не найден, также используется текущий рабочий каталог. Полученный путь нормализуется, а завершающие косые черты удаляются, кроме случая, когда путь разрешается в корневой каталог.

matchesGlob(

path: string,

pattern: string,
): boolean

Метод path.matchesGlob() определяет, соответствует ли path шаблону pattern.

isAbsolute(path: string): boolean

Определяет, является ли {path} абсолютным путём. Абсолютный путь всегда указывает на одно и то же расположение независимо от рабочего каталога.

Если заданная строка {path} имеет нулевую длину, будет возвращено false.

relative(

from: string,

to: string,
): string

Вычисляет относительный путь от {from} до {to} относительно текущего рабочего каталога. Иногда у нас есть два абсолютных пути, и нужно получить относительный путь от одного к другому. Фактически это обратное преобразование path.resolve.

dirname(path: string): string

Возвращает имя каталога из пути. Аналог команды Unix dirname.

basename(

path: string,

suffix?: string,
): string

Возвращает последнюю часть пути. Аналог команды Unix basename. Часто используется для извлечения имени файла из полного пути.

extname(path: string): string

Возвращает расширение пути: от последней '.' до конца строки в последней части пути. Если в последней части пути нет '.', либо она начинается с '.', возвращается пустая строка.

parse(path: string): ParsedPath

Создаёт объект из строки пути — противоположность format().

format(pathObject: FormatInputPathObject): string

Создаёт строку пути из объекта — противоположность parse().

toNamespacedPath(path: string): string

Только в системах Windows возвращает эквивалентный путь с префиксом пространства имён для заданного пути. Если путь не является строкой, он возвращается без изменений. Этот метод имеет смысл только в системах Windows. В системах POSIX метод не выполняет никаких действий и всегда возвращает путь без изменений.

интерфейс path.FormatInputPathObject

Использование в Deno

import { path } from "node:path";

Свойства

root: string | undefined

необязательный

Корень пути, например '/' или 'c:'

dir: string | undefined

необязательный

Полный путь к каталогу, например '/home/user/dir' или 'c:\path\dir'

base: string | undefined

необязательный

Имя файла вместе с расширением (если оно есть), например 'index.html'

ext: string | undefined

необязательный

Расширение файла (если оно есть), например '.html'

name: string | undefined

необязательный

Имя файла без расширения (если оно есть), например 'index'

интерфейс path.ParsedPath

Использование в Deno

import { path } from "node:path";

Объект с разобранным путём, созданный функцией path.parse() или используемый функцией path.format().

Свойства

root: string

Корень пути, например '/' или 'c:'

dir: string

Полный путь к каталогу, например '/home/user/dir' или 'c:\path\dir'

base: string

Имя файла вместе с расширением (если оно есть), например 'index.html'

ext: string

Расширение файла (если оно есть), например '.html'

name: string

Имя файла без расширения (если оно есть), например 'index'

интерфейс path.PlatformPath

Использование в Deno

import { path } from "node:path";

Свойства

sep: "\\" | "/"

только для чтения

Разделитель файловых путей, зависящий от платформы: '\' или '/'.

delimiter: ";" | ":"

только для чтения

Разделитель файлов, зависящий от платформы: ';' или ':'.

posix: PlatformPath

только для чтения

Обработка путей для POSIX. В POSIX соответствует родительскому объекту.

win32: PlatformPath

только для чтения

Обработка путей для Windows. В Windows соответствует родительскому объекту.

Методы

normalize(path: string): string

join(...paths: string[]): string

Объединяет все аргументы и нормализует полученный путь.

resolve(...paths: string[]): string

Крайний правый параметр считается {to}. Остальные параметры считаются массивом {from}.

Начиная с самого левого параметра {from}, преобразует {to} в абсолютный путь.

matchesGlob(

path: string,

pattern: string,
): boolean

Метод path.matchesGlob() определяет, соответствует ли path шаблону pattern.

isAbsolute(path: string): boolean

Если заданная строка {path} имеет нулевую длину, будет возвращено false.

relative(

from: string,

to: string,
): string

dirname(path: string): string

Возвращает имя каталога из пути. Аналог команды Unix dirname.

basename(

path: string,

suffix?: string,
): string

extname(path: string): string

parse(path: string): ParsedPath

Создаёт объект из строки пути — противоположность format().

format(pathObject: FormatInputPathObject): string

Создаёт строку пути из объекта — противоположность parse().

toNamespacedPath(path: string): string

пространство имён default

Использование в Deno

import mod from "node:path";

Модуль node:path предоставляет вспомогательные средства для работы с путями к файлам и каталогам. Его можно использовать следующим образом:

import path from 'node:path';

Интерфейсы

default.FormatInputPathObject

Документация недоступна

default.ParsedPath

Объект разобранного пути, созданный функцией path.parse() или используемый функцией path.format().

default.PlatformPath

Документация недоступна

См. также

исходный код

переменная default

Тип

path.PlatformPath

пространство имён path

Использование в Deno

import { path } from "node:path";

import path from 'node:path';

Интерфейсы

path.FormatInputPathObject

Документация недоступна

path.ParsedPath

Объект разобранного пути, созданный функцией path.parse() или используемый функцией path.format().

path.PlatformPath

Документация недоступна

См. также

исходный код

переменная path

Тип

path.PlatformPath