shaka-player 3.3.0 → 3.3.3

package/app-engine/shaka-player-demo/posters.py

@@ -0,0 +1,110 @@
+# Shaka Player Demo - Poster Definitions
+# Copyright 2022 Google LLC
+# SPDX-License-Identifier: Apache-2.0
+
+# A Doodle-like service to change the poster on certain days.
+# All posters are chosen based on the current date in PST.
+
+# Month constants to make specific dates easier to read.
+JANUARY = 1
+FEBRUARY = 2
+MARCH = 3
+APRIL = 4
+MAY = 5
+JUNE = 6
+JULY = 7
+AUGUST = 8
+SEPTEMBER = 9
+OCTOBER = 10
+NOVEMBER = 11
+DECEMBER = 12
+
+# Special posters for certain days.
+VIDEO_POSTERS = {
+  # These are the same every year:
+  # =====
+  (FEBRUARY, 14): 'valentines.png',
+  (APRIL, 1): 'colorbars.gif',
+  (APRIL, 5): 'trek.jpg',  # "First Contact Day": https://bit.ly/2CSXbxw
+  (OCTOBER, 31): 'zombie.jpg',
+  # =====
+
+  # These birthday posters changed each year:
+  (DECEMBER, 19, 2015): '1yo.jpg',
+  (DECEMBER, 19, 2016): '2yo.png',
+  (DECEMBER, 19, 2017): '3yo.png',
+
+  # After this, the birthday poster shows for a whole week:
+  (DECEMBER, 17, 2018): '4yo.png',
+  (DECEMBER, 18, 2018): '4yo.png',
+  (DECEMBER, 19, 2018): '4yo.png',
+  (DECEMBER, 20, 2018): '4yo.png',
+
+  (DECEMBER, 19, 2019): '5yo.png',
+  (DECEMBER, 20, 2019): '5yo.png',
+  (DECEMBER, 21, 2019): '5yo.png',
+  (DECEMBER, 22, 2019): '5yo.png',
+  (DECEMBER, 23, 2019): '5yo.png',
+  (DECEMBER, 24, 2019): '5yo.png',
+  (DECEMBER, 25, 2019): '5yo.png',
+
+  (DECEMBER, 19, 2020): '6yo.png',
+  (DECEMBER, 20, 2020): '6yo.png',
+  (DECEMBER, 21, 2020): '6yo.png',
+  (DECEMBER, 22, 2020): '6yo.png',
+  (DECEMBER, 23, 2020): '6yo.png',
+  (DECEMBER, 24, 2020): '6yo.png',
+  (DECEMBER, 25, 2020): '6yo.png',
+
+  (DECEMBER, 19, 2021): '7yo.png',
+  (DECEMBER, 20, 2021): '7yo.png',
+  (DECEMBER, 21, 2021): '7yo.png',
+  (DECEMBER, 22, 2021): '7yo.png',
+  (DECEMBER, 23, 2021): '7yo.png',
+  (DECEMBER, 24, 2021): '7yo.png',
+  (DECEMBER, 25, 2021): '7yo.png',
+
+  (DECEMBER, 19, 2022): '8yo.png',
+  (DECEMBER, 20, 2022): '8yo.png',
+  (DECEMBER, 21, 2022): '8yo.png',
+  (DECEMBER, 22, 2022): '8yo.png',
+  (DECEMBER, 23, 2022): '8yo.png',
+  (DECEMBER, 24, 2022): '8yo.png',
+  (DECEMBER, 25, 2022): '8yo.png',
+
+  (DECEMBER, 19, 2023): '9yo.png',
+  (DECEMBER, 20, 2023): '9yo.png',
+  (DECEMBER, 21, 2023): '9yo.png',
+  (DECEMBER, 22, 2023): '9yo.png',
+  (DECEMBER, 23, 2023): '9yo.png',
+  (DECEMBER, 24, 2023): '9yo.png',
+  (DECEMBER, 25, 2023): '9yo.png',
+
+  (DECEMBER, 19, 2024): '10yo.png',
+  (DECEMBER, 20, 2024): '10yo.png',
+  (DECEMBER, 21, 2024): '10yo.png',
+  (DECEMBER, 22, 2024): '10yo.png',
+  (DECEMBER, 23, 2024): '10yo.png',
+  (DECEMBER, 24, 2024): '10yo.png',
+  (DECEMBER, 25, 2024): '10yo.png',
+}
+
+# The default poster.
+VIDEO_DEFAULT = 'standard.png'
+
+# Special audio-only posters.
+AUDIO_POSTERS = {
+  # http://discordia.wikia.com/wiki/Chaoflux
+  (FEBRUARY, 19): 'audioRickRoll.gif',
+  # http://discordia.wikia.com/wiki/Discoflux
+  (MAY, 3): 'audioRickRoll.gif',
+  # http://discordia.wikia.com/wiki/Confuflux
+  (JULY, 15): 'audioRickRoll.gif',
+  # http://discordia.wikia.com/wiki/Bureflux
+  (SEPTEMBER, 26): 'audioRickRoll.gif',
+  # http://discordia.wikia.com/wiki/Afflux
+  (DECEMBER, 8): 'audioRickRoll.gif',
+}
+
+# The default audio-only poster.
+AUDIO_DEFAULT = 'audioOnly.gif'

package/app-engine/shaka-player-demo/requirements.txt

@@ -0,0 +1,5 @@
+# Shaka Player Demo - Appspot Python Runtime Requirements
+# Copyright 2022 Google LLC
+# SPDX-License-Identifier: Apache-2.0
+
+Flask==2.0.3

package/app-engine/shaka-player-demo/time.txt

@@ -0,0 +1 @@
+Time is an illusion; lunchtime doubly so.

package/build/README.md

@@ -99,7 +99,7 @@ will choose a defaults based on your platform.  However, if you pass any
 arguments to `test.py`, it will not choose browsers and you *must* pass
 `--browsers`.
 
-[lib/debug/log.js]: https://github.com/google/shaka-player/blob/master/lib/debug/log.js
+[lib/debug/log.js]: https://github.com/shaka-project/shaka-player/blob/main/lib/debug/log.js
 
 ## Stats
 

package/build/checkversion.py

@@ -37,7 +37,7 @@ def changelog_version():
   """Gets the version of the library from the CHANGELOG."""
   path = os.path.join(shakaBuildHelpers.get_source_base(), 'CHANGELOG.md')
   with shakaBuildHelpers.open_file(path, 'r') as f:
-    match = re.search(r'## (.*) \(', f.read())
+    match = re.search(r'^###? \[(.*?)\]\(', f.read(), re.MULTILINE)
     return match.group(1) if match else ''
 
 

package/build/conformance.textproto

@@ -12,297 +12,324 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-
 # Conformance requirements:
 # See: https://github.com/google/closure-compiler/wiki/JS-Conformance-Framework
 
-
 # Disallow throwing non-Error types.
 requirement: {
   type: CUSTOM
-  java_class:
-      'com.google.javascript.jscomp.ConformanceRules$BanThrowOfNonErrorTypes'
-  error_message: 'Throwing non-Error types or Error itself is not allowed; '
-                 'throw shaka.util.Error instead.'
-  whitelist_regexp: 'test/'
-  whitelist_regexp: 'node_modules/'
+  java_class: "com.google.javascript.jscomp.ConformanceRules$BanThrowOfNonErrorTypes"
+  error_message:
+    "Throwing non-Error types or Error itself is not allowed; "
+    "throw shaka.util.Error instead."
+  whitelist_regexp: "test/"
+  whitelist_regexp: "node_modules/"
 }
 requirement: {
   type: BANNED_CODE_PATTERN
-  value: 'function template() { throw new Error(); }'
-  error_message: 'Throwing non-Error types or Error itself is not allowed; '
-                 'throw shaka.util.Error instead.'
-  whitelist_regexp: 'test/'
-  whitelist_regexp: 'node_modules/'
+  value: "function template() { throw new Error(); }"
+  error_message:
+    "Throwing non-Error types or Error itself is not allowed; "
+    "throw shaka.util.Error instead."
+  whitelist_regexp: "test/"
+  whitelist_regexp: "node_modules/"
 }
 
-
 # Ban accessing members of unknown types.
 requirement: {
   type: CUSTOM
-  java_class: 'com.google.javascript.jscomp.ConformanceRules$'
-              'BanUnknownTypedClassPropsReferences'
-  error_message: 'Using properties of unknown types is not allowed; add an '
-                 'explicit type to the variable.'
-  whitelist_regexp: 'demo/'
+  java_class:
+    "com.google.javascript.jscomp.ConformanceRules$"
+    "BanUnknownTypedClassPropsReferences"
+  error_message:
+    "Using properties of unknown types is not allowed; add an "
+    "explicit type to the variable."
+  whitelist_regexp: "demo/"
 }
 requirement {
   type: CUSTOM
-  java_class: 'com.google.javascript.jscomp.ConformanceRules$BanUnknownThis'
-  error_message: 'Failed to infer type of "this"; '
-                 'please be explicit or use bind!'
+  java_class: "com.google.javascript.jscomp.ConformanceRules$BanUnknownThis"
+  error_message:
+    "Failed to infer type of \"this\"; "
+    "please be explicit or use bind!"
   # Until we can get this rule updated for ES6 static methods
   # (https://github.com/google/closure-compiler/issues/2880):
-  whitelist_regexp: 'test/test/util/canned_idb.js'
-  whitelist_regexp: 'test/assets/assets_integration.js'
+  whitelist_regexp: "test/test/util/canned_idb.js"
+  whitelist_regexp: "test/assets/assets_integration.js"
 }
 
-
 # Reject unresolved types.
 requirement {
   type: CUSTOM
-  java_class: 'com.google.javascript.jscomp.ConformanceRules$BanUnresolvedType'
-  error_message: 'Failed to resolve type!'
+  java_class: "com.google.javascript.jscomp.ConformanceRules$BanUnresolvedType"
+  error_message: "Failed to resolve type!"
 }
 
-
 # Reject global variables.
 requirement {
   type: CUSTOM
-  java_class: 'com.google.javascript.jscomp.ConformanceRules$BanGlobalVars'
-  error_message: 'Global variables are not allowed!'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'test/'
-  whitelist_regexp: 'node_modules/'
+  java_class: "com.google.javascript.jscomp.ConformanceRules$BanGlobalVars"
+  error_message: "Global variables are not allowed!"
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "test/"
+  whitelist_regexp: "node_modules/"
 }
 
-
 # Disallow using "!" on nullable numbers in boolean assignment.
 # Note: we can't use the pattern "var b = !n" because it causes too many
 # false positives.
 requirement: {
   type: BANNED_CODE_PATTERN
-  value: '/** @param {boolean} b @param {?number} n */ '
-         'function template(b, n) { b = !n; }'
-  error_message: 'Using "!" on nullable numbers in boolean assignment '
-                 'is not allowed; use an explicit comparison instead.'
-  whitelist_regexp: 'node_modules/'
+  value:
+    "/** @param {boolean} b @param {?number} n */ "
+    "function template(b, n) { b = !n; }"
+  error_message:
+    "Using \"!\" on nullable numbers in boolean assignment "
+    "is not allowed; use an explicit comparison instead."
+  whitelist_regexp: "node_modules/"
 }
 
 requirement: {
   type: BANNED_CODE_PATTERN
-  value: '/** @param {*} a'
-         '    @param {(number|string|boolean|null|undefined)} x */'
-         'function template(a, x) { expect(a).toEqual(x); }'
-  value: '/** @param {*} a'
-         '    @param {(number|string|boolean|null|undefined)} x */'
-         'function template(a, x) { expect(a).not.toEqual(x); }'
-  error_message: 'Use expect.toBe for primitives'
+  value:
+    "/** @param {*} a"
+    "    @param {(number|string|boolean|null|undefined)} x */"
+    "function template(a, x) { expect(a).toEqual(x); }"
+  value:
+    "/** @param {*} a"
+    "    @param {(number|string|boolean|null|undefined)} x */"
+    "function template(a, x) { expect(a).not.toEqual(x); }"
+  error_message: "Use expect.toBe for primitives"
 }
 
 requirement: {
   type: BANNED_CODE_PATTERN
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Uint8Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Int8Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Uint8ClampedArray(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Unt16Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Int16Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Uint32Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Int32Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Float32Array(a) }'
-  value: '/** @param {BufferSource} a */'
-         'function template(a) { new Float64Array(a) }'
-  error_message: 'Use shaka.util.BufferUtils.view* instead.'
-  whitelist_regexp: 'lib/util/buffer_utils.js'
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Uint8Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Int8Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Uint8ClampedArray(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Unt16Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Int16Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Uint32Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Int32Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Float32Array(a) }"
+  value:
+    "/** @param {BufferSource} a */"
+    "function template(a) { new Float64Array(a) }"
+  error_message: "Use shaka.util.BufferUtils.view* instead."
+  whitelist_regexp: "lib/util/buffer_utils.js"
 }
 
 requirement: {
   type: BANNED_CODE_PATTERN
-  value: 'function template () { new Date().getTime() }'
-  error_message: 'Use Date.now() instead.'
+  value: "function template () { new Date().getTime() }"
+  error_message: "Use Date.now() instead."
 }
 
 # Disallow console logging.
 requirement: {
   type: BANNED_PROPERTY_CALL
-  value: 'Console.prototype.debug'
-  value: 'Console.prototype.log'
-  value: 'Console.prototype.info'
-  value: 'Console.prototype.warn'
-  value: 'Console.prototype.error'
-  error_message: 'Using "console" is not allowed; '
-                 'use shaka.log instead'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'lib/debug/log.js'
-  whitelist_regexp: 'test/test/boot.js'
-  whitelist_regexp: 'node_modules/'
-  whitelist_regexp: '[synthetic:es6/promise/promise]'
+  value: "Console.prototype.debug"
+  value: "Console.prototype.log"
+  value: "Console.prototype.info"
+  value: "Console.prototype.warn"
+  value: "Console.prototype.error"
+  error_message:
+    "Using \"console\" is not allowed; "
+    "use shaka.log instead"
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "lib/debug/log.js"
+  whitelist_regexp: "test/test/boot.js"
+  whitelist_regexp: "node_modules/"
+  whitelist_regexp: "[synthetic:es6/promise/promise]"
 }
 
 # Disallow querySelector and querySelectorAll since they aren't supported on
 # Shaka Player Embedded.
 requirement: {
   type: BANNED_PROPERTY_CALL
-  value: 'Element.prototype.querySelector'
-  value: 'Document.prototype.querySelector'
-  value: 'Element.prototype.querySelectorAll'
-  value: 'Document.prototype.querySelectorAll'
-  error_message: 'Use getElementsByTagName'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'ui/'
-  whitelist_regexp: 'test/'
-  whitelist_regexp: 'node_modules/'
+  value: "Element.prototype.querySelector"
+  value: "Document.prototype.querySelector"
+  value: "Element.prototype.querySelectorAll"
+  value: "Document.prototype.querySelectorAll"
+  error_message: "Use getElementsByTagName"
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "ui/"
+  whitelist_regexp: "test/"
+  whitelist_regexp: "node_modules/"
 }
 
-
 # Disallow Element.children.
 requirement: {
   type: BANNED_PROPERTY
-  value: 'Element.prototype.children'
-  error_message: 'Using "Element.children" is not allowed; '
-                 'use Node.childNodes instead'
+  value: "Element.prototype.children"
+  error_message:
+    "Using \"Element.children\" is not allowed; "
+    "use Node.childNodes instead"
 }
 
 requirement: {
   type: BANNED_PROPERTY
-  value: 'DataView.prototype.buffer'
-  value: 'TypedArray.prototype.buffer'
-  error_message: 'Using "TypedArray.buffer" is not safe since it doesn\'t '
-                 'handle sub-arrays'
-  whitelist_regexp: 'lib/util/buffer_utils.js'
-  whitelist_regexp: 'lib/util/object_utils.js'
-  whitelist_regexp: 'test/util/buffer_utils_unit.js'
+  value: "DataView.prototype.buffer"
+  value: "TypedArray.prototype.buffer"
+  error_message:
+    "Using \"TypedArray.buffer\" is not safe since it doesn\'t "
+    "handle sub-arrays"
+  whitelist_regexp: "lib/util/buffer_utils.js"
+  whitelist_regexp: "lib/util/object_utils.js"
+  whitelist_regexp: "test/util/buffer_utils_unit.js"
 }
 
-
 # Disallow Element.innerHTML and outerHTML.
 requirement: {
   type: BANNED_PROPERTY
-  value: 'Element.prototype.innerHTML'
-  value: 'Element.prototype.outerHTML'
-  error_message: 'Using "Element.innerHTML" or "Element.outerHTML" is not '
-                 'allowed due to security concerns; use textContent, '
-                 'appendChild, or removeChild instead'
-  whitelist_regexp: 'test/test/util/util.js'
+  value: "Element.prototype.innerHTML"
+  value: "Element.prototype.outerHTML"
+  error_message:
+    "Using \"Element.innerHTML\" or \"Element.outerHTML\" is not "
+    "allowed due to security concerns; use textContent, "
+    "appendChild, or removeChild instead"
+  whitelist_regexp: "test/test/util/util.js"
 }
 
-
 # Disallow DOMRect.x and y.
 requirement: {
   type: BANNED_PROPERTY
-  value: 'DOMRect.prototype.x'
-  value: 'DOMRect.prototype.y'
-  error_message: 'DOMRect "x" and "y" are not supported on legacy Edge; '
-                 'use "left" and "top" instead.'
+  value: "DOMRect.prototype.x"
+  value: "DOMRect.prototype.y"
+  error_message:
+    "DOMRect \"x\" and \"y\" are not supported on legacy Edge; "
+    "use \"left\" and \"top\" instead."
   # The built-in set and map polyfills trigger this ban somehow.
-  whitelist_regexp: 'synthetic:es6/'
+  whitelist_regexp: "synthetic:es6/"
 }
 
-
 # Disallow fdescribe.
 requirement: {
   type: BANNED_NAME
-  value: 'fdescribe'
-  error_message: 'Using "fdescribe" is not allowed'
+  value: "fdescribe"
+  error_message: "Using \"fdescribe\" is not allowed"
 }
 
-
 # Disallow fit.
 requirement: {
   type: BANNED_NAME
-  value: 'fit'
-  error_message: 'Using "fit" is not allowed'
-  whitelist_regexp: 'test/player_external.js'
+  value: "fit"
+  error_message: "Using \"fit\" is not allowed"
+  whitelist_regexp: "test/player_external.js"
 }
 
-
 # Disallow setInterval.
 requirement: {
   type: BANNED_NAME
-  value: 'window.setInterval'
-  error_message: 'setInterval has several drawbacks, most of '
-                 'all difficulty canceling and surprising behavior '
-                 'when the device goes to sleep. Please use '
-                 'shaka.util.Timer instead.'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'test/'
+  value: "window.setInterval"
+  error_message:
+    "setInterval has several drawbacks, most of "
+    "all difficulty canceling and surprising behavior "
+    "when the device goes to sleep. Please use "
+    "shaka.util.Timer instead."
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "test/"
 }
 requirement: {
   type: BANNED_NAME
-  value: 'setInterval'
-  error_message: 'setInterval has several drawbacks, most of '
-                 'all difficulty canceling and surprising behavior '
-                 'when the device goes to sleep. Please use '
-                 'shaka.util.Timer instead.'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'test/'
+  value: "setInterval"
+  error_message:
+    "setInterval has several drawbacks, most of "
+    "all difficulty canceling and surprising behavior "
+    "when the device goes to sleep. Please use "
+    "shaka.util.Timer instead."
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "test/"
 }
 
 # Disallow setTimeout.
 requirement: {
   type: BANNED_NAME
-  value: 'window.setTimeout'
-  error_message: 'setTimeout has several drawbacks, most of '
-                 'all difficulty canceling it. Please use '
-                 'shaka.util.Timer instead.'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'test/'
-  whitelist_regexp: 'lib/util/delayed_tick.js'
+  value: "window.setTimeout"
+  error_message:
+    "setTimeout has several drawbacks, most of "
+    "all difficulty canceling it. Please use "
+    "shaka.util.Timer instead."
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "test/"
+  whitelist_regexp: "lib/util/delayed_tick.js"
 }
 requirement: {
   type: BANNED_NAME
-  value: 'setTimeout'
-  error_message: 'setTimeout has several drawbacks, most of '
-                 'all difficulty canceling it. Please use '
-                 'shaka.util.Timer instead.'
-  whitelist_regexp: 'demo/'
-  whitelist_regexp: 'test/'
+  value: "setTimeout"
+  error_message:
+    "setTimeout has several drawbacks, most of "
+    "all difficulty canceling it. Please use "
+    "shaka.util.Timer instead."
+  whitelist_regexp: "demo/"
+  whitelist_regexp: "test/"
 }
 
-
 # Disallow eval, except when testing for modern JS syntax in demo
 requirement: {
   type: BANNED_NAME
-  value: 'window.eval'
-  error_message: 'Using "eval" is not allowed'
-  whitelist_regexp: 'demo/demo_utils.js'
-  whitelist_regexp: 'node_modules/google-closure-library/closure/goog/base.js'
-  whitelist_regexp: 'test/util/functional_unit.js'
+  value: "window.eval"
+  error_message: "Using \"eval\" is not allowed"
+  whitelist_regexp: "demo/demo_utils.js"
+  whitelist_regexp: "node_modules/google-closure-library/closure/goog/base.js"
+  whitelist_regexp: "test/util/functional_unit.js"
 }
 requirement: {
   type: BANNED_NAME
-  value: 'eval'
-  error_message: 'Using "eval" is not allowed'
-  whitelist_regexp: 'demo/demo_utils.js'
-  whitelist_regexp: 'node_modules/google-closure-library/closure/goog/base.js'
-  whitelist_regexp: 'test/util/functional_unit.js'
+  value: "eval"
+  error_message: "Using \"eval\" is not allowed"
+  whitelist_regexp: "demo/demo_utils.js"
+  whitelist_regexp: "node_modules/google-closure-library/closure/goog/base.js"
+  whitelist_regexp: "test/util/functional_unit.js"
 }
 
-
 # Disallow ES6 methods.
 requirement: {
   type: BANNED_PROPERTY
-  value: 'ArrayBuffer.prototype.slice'
-  error_message: 'ArrayBuffer.slice is not allowed because it '
-                 'is not supported on Tizen 2016'
+  value: "ArrayBuffer.prototype.slice"
+  error_message:
+    "ArrayBuffer.slice is not allowed because it "
+    "is not supported on Tizen 2016"
 }
 
 # Disallow the general use of fetch, which is not available on all supported
 # platforms.
 requirement: {
   type: BANNED_NAME_CALL
-  value: 'fetch'
-  value: 'window.fetch'
-  error_message: 'Using "fetch" directly is not allowed; '
-                 'use shaka.test.Util.fetch or NetworkingEngine.request '
-                 'instead.'
-  whitelist_regexp: 'lib/net/http_fetch_plugin.js'
+  value: "fetch"
+  value: "window.fetch"
+  error_message:
+    "Using \"fetch\" directly is not allowed; "
+    "use shaka.test.Util.fetch or NetworkingEngine.request "
+    "instead."
+  whitelist_regexp: "lib/net/http_fetch_plugin.js"
+}
+
+# Disallow the use of generators, which are a major performance issue.  See
+# https://github.com/shaka-project/shaka-player/issues/4062#issuecomment-1079428268
+requirement: {
+  type: BANNED_CODE_PATTERN
+  value:
+    "/** @param {*} x */ "
+    "function *template(x) { yield x; }"
+  error_message:
+    "ES6 generators are a major performance issue!  Find another solution. "
+    "See also https://bit.ly/3wAsoj5"
+  whitelist_regexp: "node_modules/"
 }