Serves the vinyl stream directly
import gulp from 'gulp'
import vinylServe from 'vinyl-serve'
import someTransform from './somewhere'
gulp.src('src/**/*.js')
.pipe(someTransform())
.pipe(vinylServe(7000))
This starts the server at port 7000 and, for example, localhost:7000/foo.js
responses the transformed contents of src/foo.js
.
gulp.task('serve', function () {
gulp.src('js/**/*.js')
.pipe(someTransform())
.pipe(vinylServe(7000))
gulp.src('css/**/*.scss')
.pipe(anotherTransform())
.pipe(vinylServe(7000))
gulp.src('html/**/*.html')
.pipe(vinylServe(7000))
})
gulp.src('./js/**/*.js', {base: './'})
.pipe(someTransform())
.pipe(vinylServe(7000))
With the above example, if you have js/foo.js
, it's served at the path /js/foo.js
, not /foo.js
.
At the address __vinyl__
, you can see the debug page and find all the available paths in the server.
var vinylServe = require('vinyl-serve')
param | type | description |
---|---|---|
port | number | The port number of the server (default: 7000) |
This returns stream processor which serves the contents at the given port.
param | type | description |
---|---|---|
port | number | The port number of the server (default: 7000) |
This restarts the server at the given port number. Throws error if there is no server at the port.
param | type | description |
---|---|---|
port | number | The port number of the server (default: 7000) |
This stops the server at the given port number. Throws error if there is no server at the port.
param | type | description |
---|---|---|
port | number | The port number of the server (default: 7000) |
This returns a promise which resolves when the server of the given port is ready. Returns null when server does't exist.
vinyl-serve
has some more APIs which are maybe useful when someone wants to use this module as a part of another module.
- @param {String} title
This overrides the debug page title.
- @param {String} path
This overrides the debug page path. The path have to start with '/'. (The default is __vinyl__
.)
Example. /__mytool__
- @param {Function} handler
Sets the handler for the starting of the server. This handler is called when the server start listening. This handler is called with 2 parameters. The first one is the url of the root of the server and the second is the path of the debug page. ( e.g. http://0.0.0.0:7000/
and http://0.0.0.0:7000/__vinyl__
)
- @param {Function} handler
Sets the handler for the case of the port number error. This handler is called when the server's port is already in use. This handler is called with 1 parameter which is the port number of the server.
- @param {Function} middlware The connect middleware
This adds the connect middleware to the server.
npm install vinyl-serve
MIT
- 2018-06-09 v3.0.0 Add addMiddleware API.
- 2017-04-23 v2.7.0 Serve index.html.
- 2016-12-29 v2.6.1 Windows bug fix.
- 2016-12-29 v2.6.0 Update page design.
- 2016-12-29 v2.5.3 Windows bug fix.
- 2016-09-18 v2.4.0 Better mtime handling.
- 2016-04-17 v1.3.3 Fix bug of binary data handling.