Wait for frame change
observation.wait-changeCapture the exact target until a region changes from its baseline by the requested threshold.
Example use
After turning a page, wait for the content region to differ sufficiently from its baseline.
Node preview
Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.
Loading node preview…
Data inputs 6
- Observation region
regionRegion Region of the exact target frame to compare.
Default availableDefault:{"height":1,"unit":"ratio","width":1,"x":0,"y":0}Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}- Change threshold
thresholdNumber Report changed when the changed-cell ratio reaches this value.
Default availableDefault:0.02- Wait timeout
timeoutDuration (milliseconds) · ms Maximum milliseconds to wait for a change.
Default availableDefault:5000- Minimum: 0
- Maximum: 86400000
Value format examples
1000- Poll interval
poll-intervalDuration (milliseconds) · ms Milliseconds between fresh captures.
Default availableDefault:100- Minimum: 0
- Maximum: 86400000
Value format examples
1000- Sample grid
grid-sizeInteger Bounded downsample cell count on each axis.
Default availableDefault:32- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- Cell delta
cell-deltaInteger Color difference that marks one grid cell changed.
Default availableDefault:12- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042
Configuration 1
- Window target slot
slotText Select a target bound to an application path, window title, and window class.
RequiredDefault:None- Minimum characters: 1
- Maximum characters: 128
- Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
Data outputs 2
- Changed ratio
changed-ratioNumber Ratio of cells changed from the baseline frame.
- Mean difference
mean-differenceNumber Mean grid color difference from the baseline frame.
Control and error ports
- Input
inInput · Control - An incoming control signal enters this operation.
- Changed
changedOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Timeout
timeoutOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Failed
failedOutput · Error - Emitted when the operation fails; connect error handling here.
Version and node identity
Version 1.1.0
sha256:05f66ab06c1dc9e682227699fdba6024f9317d7726c8a3f8e35c2015ba4633e4