Handbook

Task `sharepoint_list_library_files_scroll` v1

List SharePoint library files by scroll + link harvest (read-only evaluate). Near-complete folder inventory up to limit (default cap 5000).

Updated

Task sharepoint_list_library_files_scroll v1

Summary

List SharePoint library files by scroll + link harvest (read-only evaluate). Near-complete folder inventory up to limit (default cap 5000).

Inputs

Field Type Required
session_ref string yes
query.site_url string recommended
query.max_scroll_rounds integer no (default 80)
query.stable_rounds_required integer no (default 3)
limit integer no

Output

ReadResult with source_kind: library_scroll on each item.

Timing and stability

Measure Typical live Stability
Latency 30–180 s Medium (UI/layout drift)
Item count 100–5000 May emit scroll_cap_reached at connector layer

Alternatives

Task When
sharepoint_list_library_files_rest Faster, more stable full list when cookies valid
sharepoint_list_library_files_viewport Quick visible-row smoke

Failure modes

Kind When
PlaywrightError:not_attached Invalid session_ref
Connector warning scroll_cap_reached when harvest hits cap

Examples

{
  "session_ref": "edge-session",
  "query": {
    "site_url": "https://contoso.sharepoint.com/sites/Engineering",
    "max_scroll_rounds": 120
  },
  "limit": 5000
}

Deprecated pattern

playwright_read_items with source_kind: library_scroll.

Verification

Offline scroll tests.

Changelog

Version Change
v1 Canonical scroll harvest list task

tests/playwright/test_sharepoint_scroll.py.