YouTube Helper API.
Das sind Skriptversionen, bei denen der Quelltext aktualisiert wurde. Alle Versionen anzeigen.
fix: corrected a regression introduced in the rewrite, player API retrieval logic now again correctly uses actualTargetPlayer to get preview players
fix: added missing await for fallbackGetPlayerApi in updatePlayerState to prevent Promise-related element failures.
refactor: consolidated getPlayerResponseWhenReady logic using a fetchResponse helper and streamlined the retry loop.
perf: simplified iframe metadata synchronization by leveraging { once: true } event listeners.
chore: removed redundant optional chaining (?.) on appState and availableTracks where structural existence is guaranteed.
forgot to pass some events as function params during the rewrite. fixed that.
fix: add optional chaining to player event target access to prevent null reference errors
MAJOR REWRITE Breaks compatibility with 0.x.x versions. (see new api structure in code. documentation will be updated soon)
Added: Exposed an EVENTS constants object on the public API. Consumers can and should now use youtubeHelperApi.EVENTS.XYZ instead of hardcoded strings to prevent typos and enable IDE autocomplete.
Fixed several significant memory leaks and dangling references caused by YouTube's Single Page Application (SPA) DOM caching.
Updated to refire media events from YouTube Players no matter which player the events are from. Event details like the original event source and target are passed to the custom events. Updated progress tracking to trigger and notify for video state updated in the situations that video update video stream data without either using a new player element nor fire an event.
Changed the script to only notify ads when an ad is detected instead of on all possible ad state changes.
Updated page type name of the root domain from browse to home to match the new YouTube name.
browse
home
Added a temporary way to specifically opt out of storage save/load events.
Fixed an issue that caused the GM shim to fail under certain conditions. In certain environments (Firefox + TamperMonkey tested) checking Object.getOwnPropertyDescriptor on global GM will crash the script, new version just sets without checking.
Fixed a bug the GM shim and the API proxy logic that could crash the script in very rare cases. Minor fix, should be identical in behaviour in most cases.
Fixed an issue that caused publicApi to not be returned by custom events. (Scoping issue) Make debug.log to default to calling debug.log[1].
Made API instanced with UUIDs that are registered in a global registry. Allowed debug to be controlled from the global context space. This allowed debug to be toggled from the dev console in real-time.
Atomic Debug System: Replaced the logging engine with direct function bindings for zero-overhead performance. Numeric Logging: Added support for accessing log levels via array indices (e.g., debug.log[0]) alongside named methods. Polite Read-Only Protection: Updated state proxies to silently block write attempts with a warning instead of crashing calling scripts. Switched back to the function form of 'use strict'.
'use strict'
Fixed the check order inside the trackPlaybackProgress to reflect the correct logical availability.
Added a 5th logging level.
Tweaked logging level for a few messages.
fix typo
New Debug System: Added api.debug with 4 logging levels (minimal, typical, detailed, all). Logs point to the caller's line number. New Helpers: Added reloadToCurrentProgress() and exposed gmCapabilities. Internal Improvements: Library now uses the new debug system for cleaner console output and better error handling.
api.debug
minimal
typical
detailed
all
reloadToCurrentProgress()
gmCapabilities
Moved 'use strict' to global scope. Added added a shim for Greasemonkey API functions. This should catch missing GM or permission not granted errors without crashing.
Fixed video playback language updates not being detected correctly.
Update comments and logging.
Switched to an isolated library pattern.
Updated to be a global singleton. (again) Updated to inject into the newer/broader globalThis instead of window.
globalThis
window
Made language track detection more robust. Added logic to determine if the video is auto dubbed with its own appState value.
Updated API logic to match YouTube's new audio track format.
Fixed an issue that caused the script to notify itself being ready before the data has finished populating.
Fixed a bug that caused the script process videos before all video data has loaded into the video player.
Fixed a bug that caused the video html element to become stale after reloading throw YouTube's API. This seems to be new YouTube behavior introduced by the New Delhi (2025) UI update.
Fixed a race condition where ad states and video states can update in random order depending on loading conditions.
Fixed a bug that caused player updates to be handled event when video data does not exist. Fixed a race condition bug that caused the API to return incorrect data.
fix type
Excluded certain urls from being early processed.
Updated to track if the current video has been streamed or premiered. (basically any format that could have a chat log would return true)
Updated the API to directly reference read-only proxy objects for better performance. Updated page type to use the current page URL as fallback when YouTube's native API fails to return a proper response.
Updated how the player api fallback working when running in iframes. Updated the listener player update event.
storageApi
page
reloadVideo
_
timeupdate
WeakMap
GM
Added a fuction to reload the current video.
Added distinction between content that is live or was live (VOD), and content that is currently live exclusively.
Added a private event target so we don't fire event into the document directly. Global event handshake may eventually be added.
Use a singleton pattern for initiation to avoid duplicate events firing.
Fixed tracked playback progress not updating when loading a new video.
Updated all public storage functions to eager sync between script storage and local storage. Updated page type updating to listen for different events. Should now update earlier and more consistently. Fix time specified video detection. YouTube player response object turns out to be unreliable for this.
No longer exposing storageApi. Added public delete and list functions for synced storage.
Added support for time specified video detection. Added support for playlist id detection. Exposed storagedApi to publicApi.
storagedApi
publicApi
Fixed ad detection and tracking.
Alle Skript-Versionen anzeigen
