skip-video

Makes the video skip to its end or fast forwards it with the given amount. It does it by setting the currentTime attribute of the video object.

Parameters

Name	Description	Mandatory	Default Value
playerSelector	The CSS or the XPath selector to the video element in the page.	Yes	-
xpathCondition	The XPath selector that will be used to know when to trigger the skipping logic.	Yes	-
optionalParameters	Optional parameters to configure the snippet. Any number of the supported parameters from the table below can be added to this in any order. Separate the optional parameters with space as if they are different arguments to the filter.	No

Name	Description	Default Value	Example Value
-skip-to	Determines the time of the video to skip to. If the value is zero or negative, the snippet skips to the end of the video (video.currentTime = video.duration + skipTo). If the skipTo value is positive, the snippets skips the video by the given value (video.currentTime = video.currentTime + skipTo). A small negative value like (-0.1) or zero is preferred for most of the cases as it would cause the video to nearly instantly end. Large positive values can be used to quickly fast forward a video (5-10 seconds at a time) to better mimic user behaviour and escape some detection methods. Example: If there is a 30 second ad, -0.1 is given as the skipTo parameter, the video will be instantly skipped to 29.900 (0.1 seconds before the 30 second mark). If positive 10 seconds is given as the skipTo parameter, video will be skipped to 10 seconds, 20 seconds and to 30 seconds every time there is a tick of the snippet (happens at every page mutation). If 0 is given as the skipTo parameter, video will be instantly skipped to the end (30 second mark). Unit is in seconds.	-0.1	-skip-to:10
maxAttempts	If the video is not fully loaded by the time the xPath condition is met; there is a retry mechanism in the snippet. The snippet will try to skip the video once every retryMs interval. -max-attempts parameter will determine the maximum number of attempts the snippet should do before giving up. This parameter doesn't need to be changed for most of the cases but might be useful for some circumvention scenarios.	10	-max-attemps:20
retryMs	If the video is not fully loaded by the time the xPath condition is met; there is a retry mechanism in the snippet. The snippet will try to skip the video once every -retry-ms interval. This parameter doesn't need to be changed for most of the cases. Unit is in milliseconds.	10	-retry-ms:100
-wait-until	Optional parameter that can be used to delay the running of the snippet until the given state is reached. Accepts: loading, interactive, complete, load or any event name. Pass empty string to disable.-wait-until:"" (Snippet will run immediately).	Disabled (snippet runs immediately)	-wait-until:load
-run-once	Used to disable the snippet after it has skipped the video once.	False	-run-once:true
-stop-on-video-end	Used to pause the snippet when the video is already near its end. Video is considered near its end when the difference between the video duration and the current time is less than 0.5 seconds.	False	-stop-on-video-end:true
-start-from	Used to pause the snippet when the video is already near its end. Video is considered near its end when the difference between the video duration and the current time is less than 0.5 seconds.	0	-start-from:1000
-mute-video-when-skipping	Mutes the video when the skipping logic is running.	True	-mute-video-when-skipping:false

Filter examples

The following table lists examples that use the skip-video snippet:

Filter	Result
skip-video 'video.main-video-player' './/div[contains(@class,"player-container")][contains(@class, "ad"]'	Finds the video player with main-video-player class and skips it to the end whenever the div with player-container class has the class ad attached it.
skip-video 'some-css-selector-to-video' 'xpath-condition-on-when-to-run-skipping' '-run-once:true' '-skip-to:10'	This filter will only skip 10 seconds of the video when the xpath condition first matches.
skip-video 'some-css-selector-to-video' 'xpath-condition-on-when-to-run-skipping' '-wait-until:load' '-stop-on-video-end:true'	This filter will delay the running of the snippet until the page is fully loaded and it will pause the snippet once the video is close to its end. Any number of parameters can be added to customize the snippet.