Allow removing TextTracks created by hls.js

.eslintrc.js

@@ -1,9 +1,16 @@
+const asyncKeywordConstraintMsg =
+  'The async keyword adds a `regenerator` dependency in the hls.js ES5 output not allowed in v1 due to bundle size constraints.';
+const selfVsWindowGlobalMsg =
+  'Use `self` instead of `window` to access the global context everywhere (including workers).';
+const arrayFindCompatibilityMsg =
+  'Usage of Array find method is restricted for compatibility.';
+const arrayFindIndexCompatibilityMsg =
+  'Usage of Array findIndex method is restricted for compatibility.';
+const arrayEveryCompatibilityMsg =
+  'Usage of Array every method is restricted for compatibility. Use a negative Array some check instead.';
+
 module.exports = {
-  env: {
-    browser: true,
-    commonjs: true,
-    es6: true,
-  },
+  env: { browser: true, commonjs: true, es6: true },
   globals: {
     // Allowed globals
     console: true,
@@ -24,49 +31,25 @@ module.exports = {
   // 'prettier' (https://github.com/prettier/eslint-config-prettier) must be last
   extends: ['eslint:recommended', 'prettier'],
   parser: '@typescript-eslint/parser',
-  parserOptions: {
-    sourceType: 'module',
-    project: './tsconfig.json',
-  },
-  plugins: ['@typescript-eslint', 'import'],
+  parserOptions: { sourceType: 'module', project: './tsconfig.json' },
+  plugins: ['@typescript-eslint', 'import', 'no-for-of-loops'],
   rules: {
     'no-restricted-globals': [
       2,
       {
         name: 'window',
-        message:
-          'Use `self` instead of `window` to access the global context everywhere (including workers).',
-      },
-      {
-        name: 'SourceBuffer',
-        message: 'Use `self.SourceBuffer`',
-      },
-      {
-        name: 'setTimeout',
-        message: 'Use `self.setTimeout`',
-      },
-      {
-        name: 'setInterval',
-        message: 'Use `self.setInterval`',
+        message: selfVsWindowGlobalMsg,
       },
-    ],
-
-    'no-restricted-properties': [
-      2,
-      { property: 'findIndex' }, // Intended to block usage of Array.prototype.findIndex
-      { property: 'find' }, // Intended to block usage of Array.prototype.find
+      { name: 'SourceBuffer', message: 'Use `self.SourceBuffer`' },
+      { name: 'setTimeout', message: 'Use `self.setTimeout`' },
+      { name: 'setInterval', message: 'Use `self.setInterval`' },
     ],
 
     'import/first': 1,
     'no-var': 1,
     'no-empty': 1,
     'no-unused-vars': 'warn',
-    'no-console': [
-      1,
-      {
-        allow: ['assert'],
-      },
-    ],
+    'no-console': [1, { allow: ['assert'] }],
     'no-fallthrough': 1,
     'no-case-declarations': 2,
     'no-self-assign': 1,
@@ -78,23 +61,50 @@ module.exports = {
     'no-void': 2,
     'no-useless-catch': 2,
     'no-prototype-builtins': 0,
+    'no-for-of-loops/no-for-of-loops': 2,
   },
   overrides: [
     {
-      parserOptions: {
-        project: ['./tsconfig.json'],
-      },
+      parserOptions: { project: ['./tsconfig.json'] },
       files: ['*.ts'],
       rules: {
         'no-unused-vars': 0,
         'no-undef': 0,
         'no-use-before-define': 'off',
+        'no-restricted-syntax': [
+          'error',
+          {
+            selector: 'FunctionDeclaration[async=true]',
+            message: asyncKeywordConstraintMsg,
+          },
+          {
+            selector: 'ArrowFunctionExpression[async=true]',
+            message: asyncKeywordConstraintMsg,
+          },
+          {
+            selector: 'MethodDefinition[value.async=true]',
+            message: asyncKeywordConstraintMsg,
+          },
+          {
+            selector:
+              'MemberExpression[property.name="find"][object.type="Identifier"]',
+            message: arrayFindCompatibilityMsg,
+          },
+          {
+            selector:
+              'MemberExpression[property.name="findIndex"][object.type="Identifier"]',
+            message: arrayFindIndexCompatibilityMsg,
+          },
+          {
+            selector:
+              'MemberExpression[property.name="every"][object.type="Identifier"]',
+            message: arrayEveryCompatibilityMsg,
+          },
+        ],
         'import/order': [
           'warn',
           {
-            alphabetize: {
-              order: 'asc',
-            },
+            alphabetize: { order: 'asc' },
             groups: [
               'builtin',
               'external',
@@ -108,29 +118,22 @@ module.exports = {
         ],
         'sort-imports': [
           'error',
-          {
-            ignoreCase: true,
-            ignoreDeclarationSort: true,
-          },
+          { ignoreCase: true, ignoreDeclarationSort: true },
         ],
         '@typescript-eslint/no-unused-vars': [
           'warn',
-          {
-            args: 'none',
-            caughtErrors: 'none',
-          },
+          { args: 'none', caughtErrors: 'none' },
         ],
         '@typescript-eslint/prefer-optional-chain': 2,
         '@typescript-eslint/consistent-type-assertions': [
           2,
-          {
-            assertionStyle: 'as',
-            objectLiteralTypeAssertions: 'never',
-          },
+          { assertionStyle: 'as', objectLiteralTypeAssertions: 'never' },
         ],
         '@typescript-eslint/consistent-type-imports': 'error',
         '@typescript-eslint/no-import-type-side-effects': 'error',
         '@typescript-eslint/no-restricted-imports': 'error',
+        '@typescript-eslint/no-floating-promises': 'error',
+        '@typescript-eslint/no-misused-promises': 'error',
       },
     },
   ],

.github/workflows/build.yml

@@ -50,7 +50,7 @@ jobs:
       group: 'build:build:${{ github.ref }}'
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
@@ -133,7 +133,7 @@ jobs:
       group: 'build:test_unit:${{ github.ref }}'
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: cache node_modules
         uses: actions/cache@v4
@@ -153,7 +153,7 @@ jobs:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 
@@ -177,7 +177,7 @@ jobs:
       group: 'build:cloudflare_pages:${{ github.ref }}'
       cancel-in-progress: true
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: cache node_modules
         uses: actions/cache@v4
@@ -197,7 +197,7 @@ jobs:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 
@@ -252,15 +252,15 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: use Node.js
         uses: actions/setup-node@v4
         with:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 
@@ -288,7 +288,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: cache node_modules
         uses: actions/cache@v4
@@ -308,7 +308,7 @@ jobs:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 
@@ -352,7 +352,7 @@ jobs:
             uaVersion: '75.0'
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: cache node_modules
         uses: actions/cache@v4
@@ -372,7 +372,7 @@ jobs:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 
@@ -424,7 +424,7 @@ jobs:
             os: Windows 10
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: cache node_modules
         uses: actions/cache@v4
@@ -444,7 +444,7 @@ jobs:
           node-version-file: '.node-version'
 
       - name: download build
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with:
           name: build
 

.github/workflows/codeql-analysis.yml

@@ -26,7 +26,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v3

.node-version

@@ -1 +1 @@
-22.14.0
+22.18.0

MIGRATING.md

@@ -4,7 +4,10 @@ The 1.4 version of hls.js now ships with an ESM version of the library (`dist/hl
 
 If you are using the UMD version (`dist/hls.js`), no changes are required.
 
-**Important Note:** If you are using a bundler, such as webpack, the ESM version of the package will likely be used by default. If this is the case, make sure to add the `workerPath` config option after upgrading to hls.js 1.4 or above.
+**Important Notes:**
+
+- If you are using a bundler, such as webpack, the ESM version of the package will likely be used by default. If this is the case, make sure to add the `workerPath` config option after upgrading to hls.js 1.4 or above.
+- Older web engines may experience severe performance degradation when using the ESM version of this package. If targeting older web engines, consider bundling your client application in `loose` mode to avoid additional function overhead. Alternatively, use the UMD/ES5 version of the package.
 
 # Migrating from hls.js 0.x to 1.x
 

README.md

@@ -443,6 +443,7 @@ The following players integrate HLS.js for HLS playback:
 - [CDNBye](https://github.com/cdnbye/hlsjs-p2p-engine), a p2p engine for hls.js powered by WebRTC Datachannel.
 - [M3U IPTV](http://m3u-ip.tv/browser/)
 - [ArtPlayer](https://artplayer.org/?libs=https://cdnjs.cloudflare.com/ajax/libs/hls.js/1.5.17/hls.min.js&example=hls)
+- [IPTV Player](https://iptvplayer.stream), A free web-based HLS player that lets you play HLS,DASH and MP4 streams
 
 ### They use HLS.js in production!