Библиотека WMLBrowser

Эта библиотека содержит функции, которые используются для доступа к переменным браузера.

Функция Описание

getCurrentCard()	Возвращает (относительный) адрес URL текущей карты
getVar()	Возвращает значение переменной
Go()	Переход к новой карте
NewContext()	Очищает все переменные
prev()	Переход к предыдущей карте
refresh()	Обновляет текущую карту
setvar()	Задает значение переменной

Примечание

Спецификация WML говорит, что обращения к функциям (этой? - Ред.) библиотеки, которые не поддерживаются браузером, должны возвращать invalid. В связи с этим во всех приведенных выше функциях требуется проверять возвращаемое значение и, в случае получения invalid , предпринимать необходимые действия.

Фугкция resolve()

Данная функция возвращает абсолютный адрес URL на основе указанных базового и относительного адресов url.

Синтаксис:

n = URL.resolve(baseurl, relativeurl)

Параметр Описание

n	Строка, возвращаемая функцией
baseurl	Строка (базовый url)
relativeurl	Строка (относительный url)

Пример:

var x =URL.resolve("http://www.intuit.ru", "/wml/speciality/help.wml");

Результат:

x = "http://www.intuit.ru/wml/speciality/help.wml"

Функции библиотеки URL

ФункцияОписание

escapeString()	Заменяет специальные символы в URL управляющей последовательностью
getBase()
getFragment()	Возвращает фрагмент URL
getHost()	Возвращает хост, определенный в URL
getParameters()	Возвращает параметры в последнем сегменте пути доступа URL
getPath()	Возвращает путь доступа, определенный в URL
getPort()	Возвращает номер порта, определенный в URL
getQuery()	Возвращает из URL запрос
getReferer()
getScheme()	Возвращает из URL схему
isValid()	Возвращает true, если синтаксис URL правильный, и false в противном случае
loadString()	Возвращает содержимое и тип содержимого, указанного URL
resolve()	Возвращает абсолютный адрес URL на основе базового и относительного адресов URL
unescapeString()	Заменяет управляющие последовательности в URL на символы

Функция escapeString()

Данная функция заменяет специальные символы в URL управляющей последовательностью и возвращает результат.

Синтаксис:

n = URL.escapeString(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = URL.escapeString("http://www.intuit.ru/wml/");

Результат:

x = "http%3a%2f%2fwww.intuit.ru%2fwml%2f"

Функция getCurrentCard()

Данная функция возвращает относительный адрес URL текущей карты.

Синтаксис:

n = WMLBrowser.getCurrentCard()

Параметр Описание

n	Строка, возвращаемая функцией

Пример:

var x = WMLBrowser.getCurrentCard();

Результат:

x = "first#help"

Функция getFragment()

Данная функция возвращает фрагмент url с параметром.

Синтаксис:

n = URL.getFragment(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = URL.getFragment("http://www.intuit.ru/wml#help"); var y = URL.getFragment("http://www.intuit.ru/wml");

Результат:

x = "help" y = ""

Функция getHost()

Данная функция возвращает хост (адрес интернет-узла), определенный в параметре url.

Синтаксис:

n = URL.getHost(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var a = URL.getHost("http://www.intuit.ru/wml"); var b = URL.getHost("/help/speciality");

Результат:

a = "www.intuit.ru" b = ""

Функция getParameters()

Данная функция возвращает параметры из последнего сегмента пути доступа параметра url.

Синтаксис:

n = URL.getParameters(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var a = URL.getParameters("http://www.intuit.ru/speciality;help"); var b = URL.getParameters("http://www.intuit.ru/help");

Результат:

a = "help" b = ""

Функция getQuery()

Данная функция возвращает часть URL, содержащую запрос.

Синтаксис:

n = URL.getQuery(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x =URL.getQuery("http://www.intuit.ru/go.asp?name=user"); var y =URL.getQuery("http://www.intuit.ru");

Результат:

x = "user" y = ""

Функция getVar()

Данная функция возвращает значение, указанное переменной в контексте браузера. Если переменная не существует, функция возвращает пустую строку ("").

Синтаксис:

n = WMLBrowser.getVar(variable)

Параметр Описание

n	Строка, возвращаемая функцией
variable	Строка

Пример:

var x = WMLBrowser.getVar("days");

Результат:

x = "365"

Функция go()

Данная функция осуществляет переход к новой карте (определенной новым URL) и возвращает пустую строку.

Синтаксис:

n = WMLBrowser.go(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = WMLBrowser.go(first);

Результат:

x = ""

Функция newContext()

Данная функция очищает все переменные контекста WML и возвращает пустую строку.

Синтаксис:

n = WMLBrowser.newContext()

Параметр Описание

n	Пустая строка, возвращаемая функцией

Пример:

var x = WMLBrowser.newContext();

Результат:

x = ""

Функция prev()

Данная функция предписывает браузеру WML вернуться к предыдущей карте WML и возвращает пустую строку.

Синтаксис:

n = WMLBrowser.prev()

Параметр Описание

n	Пустая строка, возвращаемая функцией

Пример:

var x = WMLBrowser.prev();

Результат:

x = ""

Функция refresh()

Данная функция обновляет текущую карту и возвращает пустую строку, если обновление прошло успешно, - или непустую строку, если обновление неудачно.

Синтаксис:

n = WMLBrowser.refresh()

Параметр Описание

n	Строка, возвращаемая функцией

Пример:

var x = WMLBrowser.setVar("week",25); var y = WMLBrowser.refresh();

Результат:

x = true y = ""

Функция unescapeString()

Данная функция заменяет управляющие последовательности в URL на закодированные ими символы.

Синтаксис:

n = URL.unescapeString(string)

Параметр Описание

n	Строка, возвращаемая функцией
string	Строка

Пример:

var x =URL.unescapeString("http%3a%2f%2fwww.intuit.ru%2wml");

Результат:

x = "http://www.intuit.ru/wml"

Функция WMLScript getPath()

Данная функция возвращает путь доступа, определенный в параметре url.

Синтаксис:

n = URL.getPath(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = URL.getPath("http://www.intuit.ru/speciality/help.htm"); var y = URL.getPath("http://www.intuit.ru");

Результат:

x = "/speciality/help.htm" y = ""

Функция WMLScript getPort()

Данная функция возвращает номер порта, определенный в параметре url.

Синтаксис:

n = URL.getPort(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = URL.getPort("http://www.intuit.ru:80"); var y = URL.getPort("http://www.intuit.ru");

Результат:

x = "80" y = ""

Функция WMLScript getScheme()

Данная функция возвращает схему, указанную в URL.

Синтаксис:

n = URL.getScheme(url)

Параметр Описание

n	Строка, возвращаемая функцией
url	Строка

Пример:

var x = URL.getScheme("www.intuit.ru"); var y = URL.getScheme("http://www.intuit.ru"); var z = URL.getScheme("ftp://www.intuit.ru");

Результат:

x = "" y = "http" z = "ftp"

Функция WMLScript isValid()

Данная функция возвращает булево значение true, если указанный URL имеет правильный синтаксис, или значение false - в противном случае.

Синтаксис:

n = URL.isValid(url)

Параметр Описание

n	Булево значение, возвращаемое функцией
url	Строка

Пример:

var x = URL.isValid("http://www.intuit.ru!!!!"); var y = URL.isValid("http:www.intuit.ru"); var z = URL.isValid("http://www.yandex.ru");

Результат:

x = "false" y = "false" z = "true"

Функция WMLScript setVar()

Данная функция задает значение указанной переменной в контексте браузера и возвращает true, если новое значение было успешно задано, и значение false - в противном случае.

Синтаксис:

n = WMLBrowser.setVar(variable, value)

Параметр Описание

n	Булево значение, возвращаемое функцией
Variable	Строка
Value	Строка

Пример:

var x = WMLBrowser.setVar("day", 15);

Результат:

x = true

---

---