ruta do módulo

O módulo de ruta é un módulo principal que proporciona funcións de utilidade para xestionar rutas a ficheiros e directorios. Non verifica se o camiño existe ou é válido, senón que só proporciona métodos para manexar o camiño

O módulo de ruta ofrece moitos métodos, os máis utilizados son:

• join(): une os fragmentos da ruta e procesaos nun formato de ruta estándar.
• resolver(): Resolve unha ruta ou secuencia de fragmentos de ruta nunha ruta absoluta.
• basename(): Devolve a última parte do camiño no camiño.
• dirname(): Devolve o nome do directorio da ruta especificada.
• extname(): Devolve a extensión do ficheiro no camiño.

Aquí tes o código de mostra para estes métodos:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
const path = require('path');

// connect path segments using the platform-specific separator as a delimiter,
console.log(path.join('/usr', 'local', 'bin')); // output: /usr/local/bin

// resolve a sequence of paths or path segments into an absolute path
console.log(path.resolve('/foo/bar', './baz')); // output: /foo/bar/baz

// return the last portion of a path
console.log(path.basename('/foo/bar/baz')); // output: baz

// return the directory name of a path
console.log(path.dirname('/foo/bar/baz')); // output: /foo/bar

// return the extension of the path, from the last '.' to end of string in the last portion of the path
console.log(path.extname('/foo/bar/baz.txt')); // output: .txt

Ademais dos métodos anteriores, o módulo de ruta tamén ofrece moitos outros métodos, como normalize(), delimitador, posix, win32, etc., para procesar a normalización de camiños, separadores de camiños, procesamento de formatos de camiños, etc. Estes métodos tamén se usan a miúdo no desenvolvemento real.

O módulo de ruta ofrécenos moitas funcións de ferramentas convenientes para procesar rutas, o que nos permite procesar rutas de ficheiros e directorios dun xeito máis cómodo. É unha das ferramentas indispensables no desenvolvemento.

función estática

normalize

Estandariza a ruta e procesa o directorio principal e outra información na ruta

1
static String path.normalize(String path);

Parámetros de chamada:

• path: String, o camiño non procesado indicado

Resultados de devolución:

• String, devolve o camiño procesado

---

basename

Consulta o nome do ficheiro na ruta. Se se especifica unha extensión, a extensión correspondente cancelarase automaticamente.

1
2
static String path.basename(String path,
    String ext = "");

Parámetros de chamada:

• path: String, o camiño da consulta dada
• ext: Cadea, especifica a extensión. Se hai unha extensión cualificada no nome do ficheiro, cancelarase automaticamente.

Resultados de devolución:

• String, devolve o nome do ficheiro

---

extname

Consulta a extensión do ficheiro na ruta

1
static String path.extname(String path);

Parámetros de chamada:

• path: String, o camiño da consulta dada

Resultados de devolución:

• String, devolve a extensión obtida

---

format

Proba a formatar un obxecto como un camiño

1
static String path.format(Object pathObject);

Parámetros de chamada:

• pathObject: Obxecto, obxecto

Resultados de devolución:

• String, devolve o camiño con formato

Os parámetros admitidos por pathObject son os seguintes:

1
2
3
4
5
6
7
{
    "root": "/",
    "dir": "/a/b",
    "base": "c.ext",
    "ext": ".ext",
    "name": "c"
}

---

parse

Analiza camiños en obxectos de camiño

1
static NObject path.parse(String path);

Parámetros de chamada:

• path: Cadena, camiño

Resultados de devolución:

• NObject, devolve o obxecto pathObject

---

dirname

Ruta de directorio na ruta de consulta

1
static String path.dirname(String path);

Parámetros de chamada:

• path: String, o camiño da consulta dada

Resultados de devolución:

• String, devolve o camiño ao directorio obtido

---

fullpath

Converte o camiño indicado nun camiño completo

1
static String path.fullpath(String path);

Parámetros de chamada:

• path: String, o camiño para a conversión dada

Resultados de devolución:

• String, devolve a ruta completa da conversión

---

isAbsolute

Identifica se o camiño indicado é un camiño absoluto

1
static Boolean path.isAbsolute(String path);

Parámetros de chamada:

• path: Cadena, dado o camiño a identificar

Resultados de devolución:

• Boolean, devolve verdadeiro se é un camiño absoluto.

---

join

Combina unha serie de camiños nun único camiño

1
static String path.join(...ps);

Parámetros de chamada:

• ps: ..., un ou varios camiños relacionados

Resultados de devolución:

• String, devolve o novo camiño obtido

---

resolve

Combina unha serie de camiños nun camiño absoluto

1
static String path.resolve(...ps);

Parámetros de chamada:

• ps: ..., un ou varios camiños relacionados

Resultados de devolución:

• String, devolve o novo camiño obtido

---

relative

Busca a ruta relativa de _de a a

1
2
static String path.relative(String _from,
    String to);

Parámetros de chamada:

• _from: Cadea, camiño de orixe
• to: Cadea, camiño de destino

Resultados de devolución:

• String, devolve o camiño relativo obtido

---

toNamespacedPath

Converte a ruta con prefixo de espazo de nomes. Só válido en Windows, outros sistemas volverán directamente.

1
static Value path.toNamespacedPath(Value path = undefined);

Parámetros de chamada:

• path: Valor, o camiño indicado.

Resultados de devolución:

• Value, devolve o novo camiño obtido

ver: https://msdn.microsoft.com/library/windows/desktop/aa365247(v=vs.85).aspx#namespaces

propiedades estáticas

sep

Cadea, consulta o carácter de separación do camiño do sistema operativo actual, posix devolve '/', windows devolve '\'

1
static readonly String path.sep;

---

delimiter

Cadea, consulta o carácter de combinación de varias rutas do sistema operativo actual, posix devolve ':', windows devolve ';'

1
static readonly String path.delimiter;

---

posix

Obxecto, implementación posix, véxpath_posix

1
static readonly Object path.posix;

---

win32

Obxecto, implementación de Windows, verpath_win32

1
static readonly Object path.win32;