Основы WAP/WML и WMLScript

Библиотеки URL и WMLBrowser

Разбить на страницы
Показывать лекцию целиком

Эта библиотека содержит функции для работы с адресами URL.

Функции библиотеки 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"

Функция 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 = ""

Функция 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 = ""

Функция 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 = ""

Функция 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"

Функция 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"

Функция 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"

Библиотека WMLBrowser

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

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

Примечание

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

Функция getCurrentCard()

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

Синтаксис:

n = WMLBrowser.getCurrentCard()
Параметр Описание
n Строка, возвращаемая функцией

Пример:

var x = WMLBrowser.getCurrentCard();

Результат:

x = "first#help"

Функция 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 = ""

Функция WMLScript setVar()

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

Синтаксис:

n = WMLBrowser.setVar(variable, value)
Параметр Описание
n Булево значение, возвращаемое функцией
Variable Строка
Value Строка

Пример:

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

Результат:

x = true
Страницы:

Эта библиотека содержит функции для работы с адресами URL.

Функции библиотеки 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"

Функция 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 = ""

Функция 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 = ""

Функция 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 = ""

Функция 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"

Функция 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"

Функция 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"

Библиотека WMLBrowser

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

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

Примечание

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

Функция getCurrentCard()

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

Синтаксис:

n = WMLBrowser.getCurrentCard()
Параметр Описание
n Строка, возвращаемая функцией

Пример:

var x = WMLBrowser.getCurrentCard();

Результат:

x = "first#help"

Функция 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 = ""

Функция WMLScript setVar()

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

Синтаксис:

n = WMLBrowser.setVar(variable, value)
Параметр Описание
n Булево значение, возвращаемое функцией
Variable Строка
Value Строка

Пример:

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

Результат:

x = true
Вернуться к учебному плану