Handbook
Task `sharepoint_list_library_files_viewport` v1
Read-only list of visible SharePoint library file links from the current viewport (single evaluate or HTML parse). Not a full-folder inventory.
Updated
Task sharepoint_list_library_files_viewport v1
Summary
Read-only list of visible SharePoint library file links from the current viewport (single evaluate or HTML parse). Not a full-folder inventory.
Inputs
| Field | Type | Required |
|---|---|---|
session_ref |
string | yes |
query.site_url |
string | recommended |
limit |
integer | no (default cap 200) |
Output
ReadResult wire JSON: schema_version, source_system: sharepoint, items[] with source_kind: library_viewport.
Timing and stability
| Measure | Typical live | Stability |
|---|---|---|
| Latency | 3–10 s | Low for “all decks” (~30 visible rows) |
| Item count | ~30 | DOM viewport bound |
Alternatives
| Task | When |
|---|---|
sharepoint_list_library_files_scroll |
Near-full folder via scroll harvest |
sharepoint_list_library_files_rest |
Full folder via OData (preferred) |
Failure modes
| Kind | When |
|---|---|
PlaywrightError:not_attached |
Invalid session_ref |
PlaywrightError:parse_failed |
Evaluate returned unexpected shape |
Examples
{
"session_ref": "edge-session",
"query": { "site_url": "https://contoso.sharepoint.com/sites/Engineering" },
"limit": 50
}
Deprecated pattern
playwright_read_items with source_kind: library_viewport.
Verification
Offline tests in test_sharepoint_reader_modern.py.
Changelog
| Version | Change |
|---|---|
| v1 | Canonical viewport list task |
tests/playwright/test_sharepoint_reader_modern.py.