Оглавление | Назад | Вперёд | Индекс

navigator

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

Создание

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

Описание

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

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

appCodeName

appName

appVersion

language

mimeTypes

platform

plugins

userAgent

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

javaEnabled

plugins.refresh

preference

savePreferences

taintEnabled

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

appCodeName

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

Примеры

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

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

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

The value of navigator.appCodeName is Mozilla

appName

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

Примеры

Здесь будет выведено значение свойства 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'а.

Описание

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

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

• 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.

Синтаксис

javaEnabled()

Параметры

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

Описание

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

Пример

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

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

См. также

language

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

Описание

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

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

mimeTypes

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

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

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

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

См. также

platform

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

Описание

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

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

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

plugins

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

Вы можете обратиться к 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'а.

Синтаксис

preference(prefName[, setValue])

Параметры

prefName

setValue

Описание

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

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

Таблица 1.2 Настройки.

general.always_load_images

security.enable_java

javascript.enabled

browser.enable_style_sheets

autoupdate.enabled

network.cookie.cookieBehavior

network.cookie.cookieBehavior

network.cookie.cookieBehavior

network.cookie.warnAboutCookies

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

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

См. также

savePreferences

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

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

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

Синтаксис

SavePreferences()

Описание

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

См. также

taintEnabled

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

Синтаксис

navigator.taintEnabled()

Описание

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

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

Примеры

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

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

См. также

userAgent

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

Описание

Сервер использует значение, пересылаемое в шапке 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