A transform stream to modify URLs contained in HLS playlists
- Being used with other
hls-streamsobjects, it provides a functionality to filter every playlists and rewrite the urls in them based on therules.
const {createReadStream} = require('hls-streams-file-reader');
const {createUrlRewriter} = require('hls-streams-url-rewriter'); // url-rewriter
const {createTerminator} = require('hls-streams-terminator')
const src = createReadStream('https://foo.bar/sample.m3u8');
const rewrite = createUrlRewriter(urlStr => {
// Convert an absolute url into a relative one
const url = new URL(urlStr);
return url.pathname;
});
const dest = createTerminator();
// Rewrite all urls
src.pipe(rewrite).pipe(dest)
.on('data', data => {
console.log(data.uri); // should be a relative url
});The features are built on top of the Node's transform streams.
Creates a new TransformStream object.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| rules | function | No | internally defined default function (see below) | A function that takes an original url string and returns a modified url string. The function is called asynchronously each time the stream encountered a url line or url attribute in playlists. |
Default behavior is something like below (pseudo code):
function defaultFunc(url) {
// Convert absolute urls into relative paths
if (url is relative) {
return url;
} else {
// Make a root directory with the hostname
return `/${url.hostname}/${url.pathname}`;
}
}An instance of TransformStream.