Handbook
Task `sharepoint_probe_library_health` v1
Read-only probe of modern SharePoint library page readiness through an attached Playwright session. Returns health fields only (no file list). Use before expensive list tasks.
Updated
Task sharepoint_probe_library_health v1
Summary
Read-only probe of modern SharePoint library page readiness through an attached Playwright session. Returns health fields only (no file list). Use before expensive list tasks.
Inputs
| Field | Type | Required | Notes |
|---|---|---|---|
session_ref |
string | yes | Attached session handle |
url |
string | no | Library entry URL |
query |
object | no | May include site_url, library_path, or url |
Output
| Field | Type | Notes |
|---|---|---|
ready |
boolean | Page usable for reads |
row_count |
integer | Grid rows detected |
file_row_count |
integer | File rows detected |
offline |
boolean | |
sign_in_required |
boolean | |
hints |
string[] | |
warnings |
object[] | Connector warnings |
Timing and stability
| Measure | Typical live | Stability |
|---|---|---|
| Latency | 2–8 s (nav + evaluate) | High for gating; not an inventory |
Failure modes
| Kind | When |
|---|---|
PlaywrightError:not_attached |
Invalid session_ref |
PlaywrightError:navigation_error |
Page not loaded |
Examples
{
"session_ref": "edge-session",
"url": "https://contoso.sharepoint.com/sites/Engineering/Forms/AllItems.aspx"
}
Deprecated alias
playwright_sharepoint_page_health.
Verification
Offline fake session tests.
tests/playwright/test_playwright_sharepoint_tasks.py.
Changelog
| Version | Change |
|---|---|
| v1 | Canonical health probe task |