Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: add added: information for path #6985

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions doc/api/path.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ paths. The file system is not consulted to check whether paths are valid.
Use `require('path')` to use this module. The following methods are provided:

## path.basename(path[, ext])
<!-- YAML
added: v0.1.25
-->

Return the last portion of a path, similar to the Unix `basename` command.
`path` must be a string. `ext`, if given, must also be a string.
Expand All @@ -23,6 +26,9 @@ path.basename('/foo/bar/baz/asdf/quux.html', '.html')
```

## path.delimiter
<!-- YAML
added: v0.9.3
-->

The platform-specific path delimiter, `;` or `':'`.

Expand All @@ -47,6 +53,9 @@ process.env.PATH.split(path.delimiter)
```

## path.dirname(path)
<!-- YAML
added: v0.1.16
-->

Return the directory name of a path, similar to the Unix `dirname` command.
`path` must be a string.
Expand All @@ -59,6 +68,9 @@ path.dirname('/foo/bar/baz/asdf/quux')
```

## path.extname(path)
<!-- YAML
added: v0.1.25
-->

Return the extension of the path, from the last '.' to end of string
in the last portion of the path. If there is no '.' in the last portion
Expand All @@ -85,6 +97,9 @@ path.extname('.index')
```

## path.format(pathObject)
<!-- YAML
added: v0.11.15
-->

Returns a path string from an object. This is the opposite of [`path.parse`][].

Expand Down Expand Up @@ -154,6 +169,9 @@ path.format({
```

## path.isAbsolute(path)
<!-- YAML
added: v0.11.2
-->

Determines whether `path` is an absolute path. An absolute path will always
resolve to the same location, regardless of the working directory. `path` must
Expand Down Expand Up @@ -182,6 +200,9 @@ path.isAbsolute('.') // false
returned.

## path.join([path1][, path2][, ...])
<!-- YAML
added: v0.1.16
-->

Join all arguments together and normalize the resulting path.

Expand All @@ -205,6 +226,9 @@ TypeError: Arguments to path.join must be strings
current working directory.

## path.normalize(path)
<!-- YAML
added: v0.1.23
-->

Normalize a path, taking care of `'..'` and `'.'` parts. `path` must be a
string.
Expand All @@ -224,6 +248,9 @@ path.normalize('/foo/bar//baz/asdf/quux/..')
will be returned, which represents the current working directory.

## path.parse(path)
<!-- YAML
added: v0.11.15
-->

Returns an object from a path. `path` must be a string.

Expand Down Expand Up @@ -256,11 +283,17 @@ path.parse('C:\\path\\dir\\index.html')
```

## path.posix
<!-- YAML
added: v0.11.15
-->

Provide access to aforementioned `path` methods but always interact in a posix
compatible way.

## path.relative(from, to)
<!-- YAML
added: v0.5.0
-->

Solve the relative path from `from` to `to`. `from` and `to` must be strings.

Expand All @@ -287,6 +320,9 @@ path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
both the paths are the same then a zero-length string will be returned.

## path.resolve([from ...], to)
<!-- YAML
added: v0.3.4
-->

Resolves `to` to an absolute path. All arguments must be strings.

Expand Down Expand Up @@ -331,6 +367,9 @@ path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif')
```

## path.sep
<!-- YAML
added: v0.7.9
-->

The platform-specific file separator. `'\\'` or `'/'`.

Expand All @@ -349,6 +388,9 @@ An example on Windows:
```

## path.win32
<!-- YAML
added: v0.11.15
-->

Provide access to aforementioned `path` methods but always interact in a win32
compatible way.
Expand Down