System object

System object

Methods of this object are not always available to the script – they depend on feature parameters of VM creation.

Constants

IS_READONLY
– int, scanFiles callback/attributes, file/dir is readonly.
IS_DIR
– int, scanFiles callback/attributes, file is directory(folder).
IS_HIDDEN
– int, scanFiles callback/attributes, file/dir is marked as hidden.
IS_SYSTEM
– int, scanFiles callback/attributes, file/dir is marked as internal for the system.
MOBILE_OS
– true for the mosciter that is running on mobile platform, false otherwise.
DESKTOP_OS
– true for the sciter running on desktop PC/platform, false otherwise.
OS
– symbol, on Windows it is one of these:
  • #Windows-98
  • #Windows-98-SE
  • #Windows-ME
  • #Windows-CE – Windows CE or Windows Mobile
  • #Windows-NT4
  • #Windows-2000
  • #Windows-2003
  • #Windows-XP
  • #Windows-Vista
  • #Windows-7
PLATFORM
– symbol, one of these:
  • #Windows
  • #OSX
  • #Linux

Properties

language
The abbreviated name of the language, ISO Standard 639 names.
country
Country/region name, based on ISO Standard 3166.
ticks
High resolution timer. Return an integer representing the time ellapsed since the engine started in milliseconds

Methods

scanFiles

( path:string [, callback:function] ) :integer

Function calls callback function for each entry found in directory defined by the path. Path can contain wildcards like ? or *. Function returns number of entries scanned.

If callback is ommited then function just returns number of items satisfying path condition. In this form the scan can be used for testing of some file existence as an example.

Callback function shall accept two parameters:

function callback( filename: string, attributes: integer ): bool

where filename is an name of the file and attributes is an integer – OR-ed combination of IS_*** flags. Callback function shall return true if further scanning needed and false to stop enumeration.

home
([relpath:string]) returns: string

Returns home folder of the application – folder where sciter started from. If relpath is some string then it will be appended to the return value. Use this if you need to find fully qualified file name residing in sciter folder or subfolder.

path
(system-folder: symbol [,relpath:string]) returns: string

Returns path of one of the system folders. system-folder here is one of:

  • #SYSTEM
  • #SYSTEM_BIN
  • #PROGRAM_FILES
  • #USER_APPDATA
  • #COMMON_APPDATA
  • #USER_DOCUMENTS
  • #COMMON_DOCUMENTS
exec
(exe-path: string [,arg1:string … argN: string]) returns: integer

Starts excutable asynchronously passing optional commnad line parameters. The method does not wait for executable to complete.

Retuns 0 if executable has started successfully and C runtime errno variable code otherwise (EACCES, ENOTDIR, etc.).