From Xojo Documentation
Jump to: navigation, search

Class (inherits from WebObject)

This is the base class for the Session class that is included in all web projects. Each user session gets its own instance of WebSession that you can access using the Session method.

NOTE: To refer to the current Session from within the Session object, use Self instead of Session as the prefix, especially in the Open event because it may return Nil.

AllowUnsupportedBrowser JavaScriptError ScaleFactorChanged
Close Open TimedOut
ConnectionTypeChanged OrientationChanged UnhandledException
HashTagChanged PrepareSession

ActiveConnectionCount ReadOnlyProperty.png HeaderCount ReadOnlyProperty.png ScaleFactor ReadOnlyProperty.png
Browser ReadOnlyProperty.png Identifier ReadOnlyProperty.png Secure ReadOnlyProperty.png
BrowserVersion ReadOnlyProperty.png LanguageCode StatusMessage
ClientTime LanguageRightToLeft Timeout
ConfirmMessage PageCount ReadOnlyProperty.png Title
CurrentPage Platform ReadOnlyProperty.png URL ReadOnlyProperty.png
GMTOffset ReadOnlyProperty.png RemoteAddress ReadOnlyProperty.png
HashTag RenderingEngine ReadOnlyProperty.png

Cookies.Count HeaderName ShowURL
Cookies.NameAtIndex PageAtIndex URLParameter
Cookies.Remove PageWithID URLParameterCount
Cookies.Set PageWithName URLParameterExists
Cookies.Value Quit URLParameterName
Header RawHeaders

Shared Methods

Dynamic Constants

These are Dynamic Constants for localizing the built-in pages of a web app.

Constant Location Default Value
ErrorDialogCancel Exception Dialog Do Not Send
ErrorDialogMessage Exception Dialog This application has encountered an error and cannot continue.
ErrorDialogQuestion Exception Dialog Please describe what you were doing right before the error occurred:
ErrorDialogSubmit Exception Dialog Send
ErrorThankYou Exception Thank You Page Thank You
ErrorThankYouMessage Exception Thank You Page Your feedback helps us make improvements.
NoJavascriptMessage Initial Page Javascript must be enabled to access this page.
NoJavascriptInstructions Initial Page To turn Javascript on, please refer to your browser settings window.


These are the enumerations you must use with the Browser, Platform, and RenderingEngine properties.

BrowserType PlatformType EngineType
Unknown Unknown Unknown
Safari Macintosh WebKit
Chrome Windows Gecko
Firefox Linux Trident
Internet Explorer Wii Presto
Opera PS3 EdgeHTML (2015r3)
ChromeOS iPhone
SafariMobile iPodTouch
Android Blackberry
Blackberry WebOS
OperaMini iPad
Epiphany AndroidTablet


Use the Session object to access the current user session.

To refer to the current Session from within the Session object, use Self instead of Session as the prefix, especially in the Open event because it may return Nil.

NOTE: Safari and Chrome (starting with v56) put background tabs into a "sleep" mode that cause Xojo web apps to display the "Application Disconnected" message if you leave a web app open in a background tab. To reconnect to the web app, refresh the tab.

Browser UI

By default, the user’s browser title displays the title of the current page. As pages are switched, the title will update accordingly. However, the developer can override the title on a session level by changing the Title property. This property overrides any page titles.


If your application is going to connect to a database server, you will want to store the database connection in a property of the Session class. This will allow your application to make connections to the server on a user-by-user basis.

Query Parameters

To access the query parameters, use the URLParameter methods to retrieve the query parameters from the Session object.

See Also

Session, WebSessionContext

Personal tools

Starting Out
Dig Deeper
More Help