content/examples/sdk/powershell/05-process-viewer.ps1
|
# 05-process-viewer.ps1 - a sortable, filterable table of running processes. # # Teaches: rendering PowerShell objects (Get-Process) as an HTML table with encoded # cells, the input event's value field (no extra round trip while typing), sorting by # clicking column headers (aria-sort), and a status line with counts. # # Run: pwsh -File ./05-process-viewer.ps1 (or powershell.exe -NoProfile -File .\05-process-viewer.ps1) # -SelfTest drives the app through the public API and quits. param([switch]$SelfTest) $ErrorActionPreference = 'Stop' Import-Module NativeHTMLKit $app = Start-NativeHTMLKitScript -Name 'Process viewer' try { $window = New-NativeHTMLKitWindow -Application $app -Title 'Processes' -Width 760 -Height 620 $doc = Open-NativeHTMLKitHtml -Window $window -Html @' <!doctype html> <html><head><style> body { font-family: system-ui, sans-serif; margin: 16px; } .bar { display: flex; gap: 8px; align-items: center; margin-bottom: 10px; } #filter { flex: 1; padding: 6px 8px; font-size: 14px; } table { border-collapse: collapse; width: 100%; font-size: 13px; } th, td { text-align: left; padding: 4px 8px; border-bottom: 1px solid #ddd; } th { background: #eef1f6; } th button { all: unset; cursor: default; font-weight: 700; } td.num, th.num { text-align: right; } #status { color: #555; font-size: 13px; margin-top: 8px; } </style></head> <body> <div class="bar"> <input id="filter" placeholder="Filter by name or id" aria-label="Filter"> <button id="refresh">Refresh</button> </div> <table> <thead><tr id="headers"> <th aria-sort="none" id="col-Name"><button id="sort-Name">Name</button></th> <th class="num" aria-sort="none" id="col-Id"><button id="sort-Id">PID</button></th> <th class="num" aria-sort="descending" id="col-MemoryMB"><button id="sort-MemoryMB">Memory (MB)</button></th> <th class="num" aria-sort="none" id="col-CpuSeconds"><button id="sort-CpuSeconds">CPU (s)</button></th> </tr></thead> <tbody id="rows"></tbody> </table> <p id="status"></p> </body></html> '@ $script:snapshot = @() $script:filterText = '' $script:sortBy = 'MemoryMB' $script:descending = $true $script:columns = @('Name', 'Id', 'MemoryMB', 'CpuSeconds') function Update-Snapshot { # Plain data only: the view never holds live Process objects. $script:snapshot = @(Get-Process | ForEach-Object { $cpu = $null try { $cpu = $_.CPU } catch { $cpu = $null } # access can be denied for other users' processes if ($null -eq $cpu) { $cpu = 0 } [pscustomobject]@{ Name = $_.ProcessName; Id = $_.Id MemoryMB = [Math]::Round($_.WorkingSet64 / 1MB, 1); CpuSeconds = [Math]::Round([double]$cpu, 1) } }) } function Update-Table { $rows = @($script:snapshot) if ($script:filterText) { $needle = $script:filterText $rows = @($rows | Where-Object { $_.Name -like "*$needle*" -or [string]$_.Id -eq $needle }) } $rows = @($rows | Sort-Object -Property $script:sortBy -Descending:$script:descending | Select-Object -First 200) $html = New-Object System.Text.StringBuilder foreach ($p in $rows) { [void]$html.Append('<tr><td>' + [Net.WebUtility]::HtmlEncode($p.Name) + '</td><td class="num">' + $p.Id + '</td><td class="num">' + $p.MemoryMB.ToString('N1') + '</td><td class="num">' + $p.CpuSeconds.ToString('N1') + '</td></tr>') } Set-NativeHTMLKitDocumentHtml -Document $doc -Element rows -Html $html.ToString() foreach ($column in $script:columns) { $sort = 'none' if ($column -eq $script:sortBy) { $sort = 'ascending'; if ($script:descending) { $sort = 'descending' } } Set-NativeHTMLKitDocumentAttribute -Document $doc -Element "col-$column" -Name 'aria-sort' -Value $sort } Set-NativeHTMLKitDocumentText -Document $doc -Element status -Text ("Showing $($rows.Count) of $($script:snapshot.Count) processes. Updated " + (Get-Date).ToString('T') + '.') } # The input event carries the control's current value; no Get-NativeHTMLKitValue needed. $null = Register-NativeHTMLKitDocumentEvent -Document $doc -Type input -Element filter -Callback { param($evt) $script:filterText = ([string]$evt.value).Trim() Update-Table } $null = Register-NativeHTMLKitDocumentEvent -Document $doc -Type click -Element headers -Callback { param($evt) if ($evt.element -notmatch '^sort-(\w+)$') { return } if ($script:sortBy -eq $Matches[1]) { $script:descending = -not $script:descending } else { $script:sortBy = $Matches[1]; $script:descending = $Matches[1] -ne 'Name' } Update-Table } $null = Register-NativeHTMLKitDocumentEvent -Document $doc -Type click -Element refresh -Callback { Update-Snapshot; Update-Table } Update-Snapshot Update-Table Set-NativeHTMLKitReady -Application $app if ($SelfTest) { $total = (Find-NativeHTMLKitElement -Document $doc -Selector '#rows tr').matched_nodes if ($total -lt 2) { throw "expected several processes, found $total" } $script:filterText = [string]$PID # this backend's own process id Update-Table if ((Find-NativeHTMLKitElement -Document $doc -Selector '#rows tr').matched_nodes -ne 1) { throw 'PID filter should match one row' } $script:filterText = ''; $script:sortBy = 'Name'; $script:descending = $false Update-Table if ((Invoke-NativeHTMLKitDocumentCommand -Document $doc -Operation get_attribute -Parameters @{ element = 'col-Name'; name = 'aria-sort' }).value -ne 'ascending') { throw 'aria-sort not updated' } [Console]::Out.WriteLine('SELFTEST PASS 05-process-viewer') $null = Request-NativeHTMLKitQuit -Application $app } Wait-NativeHTMLKit -Application $app -UntilShutdown } finally { Close-NativeHTMLKit -Application $app } |