wishthis/node_modules/is-path-inside/readme.md

64 lines
1.3 KiB
Markdown
Raw Normal View History

2023-08-17 09:47:40 +00:00
# is-path-inside
2022-01-21 08:28:41 +00:00
> Check if a path is inside another path
## Install
```
2023-08-17 09:47:40 +00:00
$ npm install is-path-inside
2022-01-21 08:28:41 +00:00
```
## Usage
```js
2023-08-17 09:47:40 +00:00
const isPathInside = require('is-path-inside');
2022-01-21 08:28:41 +00:00
isPathInside('a/b/c', 'a/b');
//=> true
isPathInside('a/b/c', 'x/y');
//=> false
isPathInside('a/b/c', 'a/b/c');
//=> false
isPathInside('/Users/sindresorhus/dev/unicorn', '/Users/sindresorhus');
//=> true
```
2023-08-17 09:47:40 +00:00
## API
2022-01-21 08:28:41 +00:00
2023-08-17 09:47:40 +00:00
### isPathInside(childPath, parentPath)
Note that relative paths are resolved against `process.cwd()` to make them absolute.
**Important:** This package is meant for use with path manipulation. It does not check if the paths exist nor does it resolve symlinks. You should not use this as a security mechanism to guard against access to certain places on the file system.
#### childPath
Type: `string`
The path that should be inside `parentPath`.
#### parentPath
Type: `string`
The path that should contain `childPath`.
---
<div align="center">
<b>
<a href="https://tidelift.com/subscription/pkg/npm-is-path-inside?utm_source=npm-is-path-inside&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
</b>
<br>
<sub>
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
</sub>
</div>