Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

WebView.GetPlainText

Queries the current text of the document.

Component Version macOS Windows Linux Server iOS SDK
WebView 3.1 ✅ Yes ✅ Yes ❌ No ❌ No ✅ Yes
MBS( "WebView.GetPlainText"; WebViewerRef )   More

Parameters

Parameter Description Example
WebViewerRef Either the Web Viewer Object Name or the Web Viewer ID as returned by "WebView.FindByName" function.

Result

Returns text or error.

Description

Queries the current text of the document.
No formatting, but only the text. This may show more/less text than you see.
For websites with frames, result may only contain the main frame and not any child frames.

See also WebView.GetHTMLText, WebView.GetFormattedText and WebView.SelectedText.
Alternative you can run JavaScript to query document.body.parentElement.outerText yourself.

Due to a bug in IE on Windows, you may see CSS in the text returned.

Examples

Query plain text from WebViewer:

MBS("WebView.GetPlainText"; "web")

Query html text from WebViewer:

MBS("WebView.GetHTMLText"; "web")

Query formatted text from WebViewer:

MBS("WebView.GetFormattedText"; "web")

Query selected text:

MBS("WebView.SelectedText"; "web")

Wait for some text to show up on website:

Pause/Resume Script [ Duration (seconds): 1 ]
Set Variable [ $count ; Value: 0 ]
Loop
    Set Variable [ $text ; Value: MBS("WebView.GetPlainText"; "web") ]
    Exit Loop If [ Position ( $text; "following quotes"; 1; 1 ) > 1 ]
    Pause/Resume Script [ Duration (seconds): 1 ]
    Set Variable [ $count ; Value: $count + 1 ]
    If [ $count = 60 ]
        Show Custom Dialog [ "Timeout" ; "Failed to load website and get the quotes text." ]
        Exit Script [ Text Result: ]
    End If
End Loop
Pause/Resume Script [ Duration (seconds): 1 ]

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 4th November 2021


WebView.GetPageSizeMultiplier - WebView.GetPreferences