На главную страницу
Форум txt.version   




Статья :: navigator
Оглавление | Назад | Вперёд | Индекс

navigator

Содержит информацию об используемой версии Navigator'а.

Клиентский объект

Реализовано в

JavaScript 1.0

JavaScript 1.1: добавлены свойства mimeTypes и plugins; добавлены методы javaEnabled и taintEnabled.

JavaScript 1.2: добавлены свойства language и platform; добавлены методы preference и savePreferences.

Создание

Машина выполнения JavaScript на стороне клиента создаёт объект navigator автоматически.

Описание

Используйте объект navigator для определения версии используемого Navigator'а (браузера), какие MIME-типы может обрабатывать Navigator пользователя и какие plug-in'ы установлены у пользователя. Все свойства объекта navigator - только для чтения/read-only.

Свойства. Резюме.

Свойство Описание
appCodeName

Специфицирует кодовое имя браузера.

appName

Специфицирует  имя браузера.

appVersion

Специфицирует версию Navigator'а.

language

Язык Navigator'а.

mimeTypes

Массив всех MIME-типов, поддерживаемых клиентом.

platform

Тип машины, для которого Navigator был скомпилирован.

plugins

Массив всех plug-in'ов, установленных на клиенте.

userAgent

Специфицирует шапку/header user-agent (пользовательский агент).

Методы. Резюме.

Метод Описание
javaEnabled

Проверяет, включён ли Java.

plugins.refresh

Делает вновь установленные plug-in'ы доступными и по выбору перезагружает открытые документы, содержащие plug-in'ы.

preference

Даёт возможность помеченному скрипту получать и устанавливать определённые настройки Navigator'а.

savePreferences

Сохраняет настройки Navigator'а в локальном файле prefs.js.

taintEnabled

Специфицирует, включено ли разрушение данных.

Кроме того, этот объект наследует методы watch и unwatch из объекта Object.

appCodeName


Строка, специфицирующая кодовое имя браузера.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.0

Примеры

Здесь выводится значение свойства appCodeName:

document.write("The value of navigator.appCodeName is " +
   navigator.appCodeName)

Для Navigator'а 2.0 и позднее будет выведено:

The value of navigator.appCodeName is Mozilla

appName


Строка, специфицирующая имя браузера.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.0

Примеры

Здесь будет выведено значение свойства appName:

document.write("The value of navigator.appName is " +
   navigator.appName)

Для Navigator'а 2.0 и 3.0 будет выведено:

The value of navigator.appName is Netscape

appVersion


Строка, специфицирующая информацию о версии Navigator'а.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.0

Описание

Свойство appVersion специфицирует информацию о версии в следующем формате:

releaseNumber (platform; country)

Содержащиеся значения:

  • releaseNumber - номер версии Navigator'а. Например, "2.0b4" специфицирует Navigator 2.0, beta 4.
  • platform - платформа на которой работает Navigator. Например, "Win16" специфицирует 16-битную версию Windows, такую как Windows 3.1.
  • country это либо "I" для международной версии, либо "U" - для релиза США. Релиз для США имеет более надёжное кодирование информации, чем международный релиз.

Примеры

Пример 1. Выводится номер версии Navigator'а:

document.write("The value of navigator.appVersion is " +
   navigator.appVersion)

Для Navigator 2.0 в Windows 95 будет выведено:

The value of navigator.appVersion is 2.0 (Win95, I)

Для Navigator 3.0 в Windows NT будет выведено:

The value of navigator.appVersion is 3.0 (WinNT, I)

Пример 2. Объект Textarea заполняется символами новой строки. Поскольку эти символы различны на разных платформах, пример тестирует свойство appVersion, чтобы определить, используется ли Windows (appVersion содержит "Win" для всех версий Windows). Если пользователь работает в Windows, символ новой строки будет \r\n; иначе - \n, то есть символ новой строки в Unix и Macintosh.

ПРИМЕЧАНИЕ: Этот код нужен только для JavaScript 1.0. Версии JavaScript от 1.1 и позднее проверяют все символы новой строки перед установкой строкового значения и транслируют их для имеющейся пользовательской платформы.

<SCRIPT>
var newline=null
function populate(textareaObject){
   if (navigator.appVersion.lastIndexOf('Win') != -1)
      newline="\r\n"
      else newline="\n"
   textareaObject.value="line 1" + newline + "line 2" + newline
   + "line 3"
}
</SCRIPT>
<FORM NAME="form1">
<BR><TEXTAREA NAME="testLines" ROWS=8 COLS=55></TEXTAREA>
<P><INPUT TYPE="button" VALUE="Populate the Textarea object"
   onClick="populate(document.form1.testLines)">
</TEXTAREA>
</FORM>

javaEnabled


Проверяет, включён ли Java.

Метод из

navigator

Static

Реализован в

JavaScript 1.1

Синтаксис

javaEnabled()

Параметры

Отсутствуют.

Описание

javaEnabled возвращает true, если Java включён; иначе - false. Пользователь может включить и отключить Java в установках пользователя.

Пример

выполняется функция function1, если Java включён; иначе выполняется function2.

if (navigator.javaEnabled()) {
   function1()
}
else function2()

См. также

navigator.appCodeName, navigator.appName, navigator.userAgent

language


Указывает используемую локализацию Navigator'а.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.2

Описание

Значение языка/language это обычно 2-буквенный код, такой как "en", иногда - 5-символьный код, указывающий также подтип языка, такой как "zh_CN".

Используйте это свойство для определения языка клиентского программного обеспечения Navigator'а. Например, Вы можете отобразить пользователю локализованный текст.

mimeTypes


Массив всех MIME-типов, поддерживаемых клиентом.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.1

Массив mimeTypes содержит вхождение для каждого MIME-типа, поддерживаемого клиентом (внутренне - через вспомогательные приложения, или через plug-in'ы). Например, если клиент поддерживает три MIME-типа, эти MIME-типы отражаются как navigator.mimeTypes[0], navigator.mimeTypes[1] и navigator.mimeTypes[2].

Каждый элемент массива mimeTypes это объект MimeType.

Для получения количества поддерживаемых mime-типов используйте свойство length: navigator.mimeTypes.length.

См. также

MimeType

platform


Указывает тип машины, для которого скомпилирован Navigator.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.2

Описание

Значения платформ: Win32, Win16, Mac68k, MacPPC и различные варианты Unix.

Тип машины, для которого Navigator скомпилирован, может отличаться от реального типа машины по причине различий версий, разных эмуляторов или по другим показателям.

Если Вы используете SmartUpdate для загрузки программного обеспечения на пользовательскую машину, Вы можете использовать это свойство, чтобы убедиться, что тригер загружает соответствующие JAR-файлы. Страница-переключатель/тригер проверяет версию Navigator'а перед проверкой свойства platform. Об использовании SmartUpdate см. Using JAR Installation Manager for SmartUpdate.

plugins


Массив всех plug-in'ов, установленных в данный момент на клиенте.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.1

Вы можете обратиться к Plugin-объектам, установленным на клиенте, используя этот массив. Каждый элемент массива plugins это Plugin-объект. Например, если на клиенте установлены три plug-in'а, они отражаются как navigator.plugins[0], navigator.plugins[1] и navigator.plugins[2].

Две формы использования массива plugins:

1. navigator.plugins[index]
2. navigator.plugins[index][mimeTypeIndex]

index это целое число, представляющее plug-in, установленный на клиенте, или строка содержащая имя Plugin-объекта (из свойства name). Первая форма возвращает Plugin-объект, хранимый в специфицированном месте в массиве plugins. Вторая форма возвращает MimeType-объект по специфицированному индексу в этом Plugin-объекте.

Для получения общего количества plug-in'ов, установленных на клиенте, используйте свойство length: navigator.plugins.length.

plugins.refresh Массив plugins имеет свой собственный метод refresh. Этот метод делает доступными вновь установленные plug-in'ы, обновляет соответствующие массивы, такие как plugins и по выбору перезагружает открытые документы,  содержащие plug-in'ы. Этот метод вызывается одним из следующих операторов:

navigator.plugins.refresh(true)
navigator.plugins.refresh(false)

Если Вы задаёте true, refresh обновляет массив plugins, чтобы сделать вновь установленные plug-in'ы доступными, и перезагружает все открытые документы, содержащие внедрённые объекты (тэг EMBED). Если Вы задаёте false, массив plugins обновляется, но открытые документы не перезагружаются.

Если пользователь устанавливает plug-in, этот plug-in недоступен, пока не будет вызван метод refresh или пока пользователь не закроет и не рестартует Navigator.

Пример

Этот код обновляет массив и перезагружает открытые документы, содержащие внедрённые объекты:

navigator.plugins.refresh(true)

См. также примеры для объекта Plugin.

preference


Позволяет помеченному скрипту получать и устанавливать определённые настройки Navigator'а.

Метод из

navigator

Static

Реализован в

JavaScript 1.2

Синтаксис

preference(prefName[, setValue])

Параметры

prefName

Строка - имя настройки, значение которой Вы хотите получить или установить. Допустимые значения перечислены ниже.

setValue

Значение, которое Вы хотите присвоить настройке. Это может быть строка, число или Булево значение.

Описание

Этот метод возвращает значение настройки. Если Вы используете этот метод для установки настройки, он возвращает новое значение.

При наличии разрешения Вы можете получать и устанавливать настройки, показанные в таблице:

Таблица 1.2 Настройки.
Чтобы ... установите в эту настройку ... это значение ...

Автоматически загрузить изображения

general.always_load_images

true или false

Включить Java

security.enable_java

true или false

Включить JavaScript

javascript.enabled

true или false

Включить таблицы стилей

browser.enable_style_sheets

true или false

Включить SmartUpdate

autoupdate.enabled

true или false

Принимать все куки/cookies

network.cookie.cookieBehavior

0

Принимать только куки, которые отправляются обратно серверу

network.cookie.cookieBehavior

1

Отключить куки

network.cookie.cookieBehavior

2

Предупреждать перед получением куки

network.cookie.warnAboutCookies

true или false

Безопасность

Чтение настройки методом preference требует привилегии UniversalPreferencesRead. Установка настройки этим методом требует привилегии UniversalPreferencesWrite. об безопасности см. книгу Клиентский JavaScript. Руководство.

См. также

savePreferences

savePreferences


Сохраняет настройки Navigator'а в локальном файле prefs.js.

Метод из

navigator

Static

Реализован в

JavaScript 1.2

Безопасность

Сохранение пользовательских настроек требует привилегии UniversalPreferencesWrite. О безопасности см. книгу Клиентский JavaScript. Руководство.

Синтаксис

SavePreferences()

Описание

Этот метод немедленно сохраняет текущие настройки Navigator'а в пользовательском файле настроек prefs.js. Navigator также сохраняет настройки автоматически при выходе из программы.

См. также

preference

taintEnabled


Специфицирует, включено ли по умолчанию разрушение данных.

Метод из

navigator

Static

Реализован в

JavaScript 1.1

JavaScript 1.2: removed

Синтаксис

navigator.taintEnabled()

Описание

Разрушение данных предотвращает передачу секретной/закрытой информации, такой как структура директорий или история пользовательских сессий. JavaScript не может передать разрушенные значения на любой сервер без окончания действия разрешений конечного пользователя.

Используйте taintEnabled для определения того, включено ли по умолчанию разрушение данных. taintEnabled возвращает true, если разрушение данных включено, иначе - false. Пользователь включает или отключает разрушение данных, используя переменную окружения NS_ENABLE_TAINT.

Примеры

Выполняется функция function1, если разрушение данных включено; иначе - выполняется function2.

if (navigator.taintEnabled()) {
   function1()
   }
else function2()

См. также

taint, untaint

userAgent


Строка, представляющая значение шапки user-agent, пересылаемой по HTTP-протоколу с клиента на сервер.

Свойство из

navigator

Только для чтения

Реализовано в

JavaScript 1.0

Описание

Сервер использует значение, пересылаемое в шапке user-agent, для идентификации клиента.

Примеры

Выводится информация userAgent для Navigator'а:

document.write("The value of navigator.userAgent is " +
   navigator.userAgent)

Для Navigator 2.0 будет выведено следующее:

The value of navigator.userAgent is Mozilla/2.0 (Win16; I)
Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation

navigator

страницы в данном разделе 
 ancor  applet
 area.htm  array
 Индекс  Boolean
 button  Checkbox
 Классы, Конструкторы и Методы Java  Значения Цветов
 Оглавление  Куки Netscape
 date.htm  document
 event  FileUpload
 form.htm  Frame
 Function  Обработчики Событий
 Hidden  History
 Image  Оглавление
 java.htm  JavaArray
 JavaClass  JavaObject
 JavaPackage  Приложение A. Зарезервированные Слова
 Layer  JSException
 JSObject  Plugin
 link.htm  Location
 math.htm  MimeType
 navigator  netscape
 Number  Object
 Объекты, Методы и Свойства  Операции
 Option  Packages
 Приложения  Справочник по Классам LiveConnect
 Элементы Языка  Объекты. Справочник.
 Password  Plugin
 Об Этой Книге  Radio
 RegExp  Reset
 screen  Select
 Операторы  String
 Style  Submit
 sun.htm  text.htm
 Textarea  toc.htm
 Свойства и Функции Верхнего Уровня  Новые Возможности в Этой Версии
 window   


Разделы
Околокомпьютерная литература (375)
Программирование (102)
Программы (75)
ОС и Сети (49)
Интернет (29)
Аппаратное обеспечение (16)
Базы данных (6)

Содержание сайта (выборка)
Apache
Протоколы TCP/IP (принципы, протоколы и архитектура)

PHP, PELR, JSP
PHP
JavaServer Pages (JSP)

Базы данных
Основы mysql
СУБД INFORMIX
СУБД POSTGRES
Основы проектирования реляционных баз данных

HTML, javascript
Спецификация HTML 4.01
Каскадные Таблицы Стилей, Уровень 2
Клиентский JavaScript. Справочник.
JavaScript руководство пользователя
Серверный JavaScript 1.4. Руководство по Использованию.

Паскаль, C, C++, C#
GCC (примеры)
FAQ Валентинa Озеровa DELPHI
C





 
©  programming-lang.com  справочник программиста