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
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
-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:
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.
Last updated