| Server IP : 68.183.124.220 / Your IP : 216.73.217.137 Web Server : Apache/2.4.18 (Ubuntu) System : Linux Sandbox-A 4.4.0-210-generic #242-Ubuntu SMP Fri Apr 16 09:57:56 UTC 2021 x86_64 User : gavin ( 1000) PHP Version : 7.0.33-0ubuntu0.16.04.16 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority, MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /home/gavin/workspace/readjs/node_modules/vinyl-file/ |
Upload File : |
# vinyl-file [](https://travis-ci.org/sindresorhus/vinyl-file)
> Create a [vinyl file](https://github.com/wearefractal/vinyl) from an actual file
## Install
```
$ npm install --save vinyl-file
```
## Usage
```js
const vinylFile = require('vinyl-file');
const file = vinylFile.readSync('index.js');
console.log(file.path);
//=> '/Users/sindresorhus/dev/vinyl-file/index.js'
console.log(file.cwd);
//=> '/Users/sindresorhus/dev/vinyl-file'
```
## API
### read(path, [options], callback)
Create a vinyl file and pass it to the callback.
### readSync(path, [options])
Create a vinyl file synchronously and return it.
#### options
##### base
Type: `string`
Default: `process.cwd()`
Override the `base` of the vinyl file.
##### cwd
Type: `string`
Default: `process.cwd()`
Override the `cwd` (current working directory) of the vinyl file.
##### buffer
Type: `boolean`
Default: `true`
Setting this to `false` will return `file.contents` as a stream. This is useful when working with large files. **Note:** Plugins might not implement support for streams.
##### read
Type: `boolean`
Default: `true`
Setting this to `false` will return `file.contents` as null and not read the file at all.
## License
MIT © [Sindre Sorhus](http://sindresorhus.com)