[Содержание] [Предыдущая] [Следующая] [Индекс]

navigator

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

Объект client-side
Реализовано в Navigator 2.0
Navigator 3.0: добавлены свойства
mimeTypes и plugins; добавлены методы javaEnabled и taintEnabled.
Navigator 4.0: добавлены свойства language и platform; добавлен метод preference.

Создание

Двигатель времени выполнения JavaScript на клиенте автоматически создает объект navigator.

Описание

Используйте объект navigator, чтобы определить, которую версию Navigator Ваши пользователи имеют, какие MIME типы Navigator пользователя может обрабатывать, какие plug-in пользователь установил. Все свойства объекта navigator только для чтения.

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

appCodeName
Определяет кодовое имя браузера.
appName
Определяет имя браузера.
appVersion
Определяет информацию о версии Navigator'а.
language
Указывает язык, используемый Navigator'ом.
mimeTypes
Массив всех MIME типов, поддерживаемых клиентом.
platform
Указывает тип машинный, для которой Navigator компилировался.
plugins
Массив всех plug-in, в настоящее время установленных на клиенте.
userAgent
Определяет заголовок агента пользователя.

Резюме Методов

javaEnabled
Проверяет, доступен ли Java.
plugins.refresh
Делает недавно установленные plug-in доступными и факультативно перезагружает открытые документы, которые содержат plug-in.
preference
Позволяет подписанному сценарию получать и устанавливать некоторые свойства Navigator'а.
taintEnabled
Определяет, допускается ли заражение данных.

Свойства

appCodeName

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

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 2.0

Примеры

Следующий пример показывает значение свойства appCodeName:

document.write("Свойство navigator.appCodeName равно " +
   navigator.appCodeName)
Для Navigator 2.0 and 3.0, он показывает следующее:

Свойство navigator.appCodeName равно Mozilla

appName

Строка, определяющая имя браузера.

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 2.0

Примеры

Следующий пример показывает значение свойства appName:

document.write("Значение of navigator.appName равно " +
   navigator.appName)
Для Navigator 2.0 and 3.0, он показывает следующее:

Значение navigator.appName равно Netscape

appVersion

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

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 2.0

Описание

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

releaseNumber (platform; country)

Значения, содержащиеся в этом формате следующие:

Примеры

Пример 1. Следующий пример показывает информацию о версии Navigator:

document.write("Значение navigator.appVersion равно " +
   navigator.appVersion)
Для Navigator 2.0 под Windows 95, он показывает следующее:

Значение navigator.appVersion равно 2.0 (Win95, I)
Для Navigator 3.0 под Windows NT, он показывает следующее:

Значение navigator.appVersion равно 3.0 (WinNT, I)
Пример 2. Следующий пример заполняет объекты Textarea с символами новой строки, отделяющими каждую строку. Так как символ новой строки изменяется от платформы к платформе, пример проверяет свойство appVersion, чтобы определить, работает ли пользователь Windows (appVersion содержит "Win" для всех версий Windows). Если пользователь работает Windows, символ новой строки устанавливается в \r\n; иначе, он установлен в \n, который является символом новой строки для Unix и Macintosh.

<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="Заполнить объект Textarea"
   onClick="populate(document.form1.testLines)">
</TEXTAREA>
</FORM>

language

Указывает язык, используемый Navigator'ом.

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 4.0

Описание

Значение языка это обычно двухсимвольный код, типа "en" и иногда пятисимвольный код, чтобы указать подтип языка, типа "zh_CN".

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

mimeTypes

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

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 3.0

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

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

Смотрите также

MimeType

platform

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

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 4.0

Описание

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

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

Если Вы используете SmartUpdate, чтобы загрузить программное обеспечение на машину пользователя, Вы можете использовать это свойство, чтобы гарантировать, что вызов загрузит соответствующие JAR файлы. Вызванная страница проверяет версию Navigator перед проверкой свойства платформы. Для информации об использовании SmartUpdate, смотрите Использование JAR Администратора Установки для SmartUpdate.

plugins

Массив всех plug-in, в настоящее время установленных на клиенте.

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 3.0

Вы можете ссылаться к объектам Plugin, установленным на клиенте, используя этот массив. Каждый элемент массива plugins это объект Plugin. Например, если три plug-in установлены на клиенте, эти 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, сохраненный в определенном месте в массиве plugin. Вторая форма возвращает объект 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.

userAgent

Строка, представляющая значение заголовка агента пользователя, посылаемого по HTTP протоколу от клиента на сервер.

Свойство объекта navigator
Только для чтения
Реализовано в Navigator 2.0

Описание

Серверы используют значение, представляющее заголовок агента пользователя, чтобы идентифицировать клиента.

Примеры

Следующий пример показывает userAgent информацию для Navigator:

document.write("Значение navigator.userAgent равно " +
   navigator.userAgent)
Для Navigator 2.0, это показывает следующее:

Значение navigator.userAgent равно Mozilla/2.0 (Win16; I)

Методы

javaEnabled

Проверяет, доступен ли Java.

Метод объекта navigator
Статический
Реализовано в Navigator 3.0

Синтаксис

javaEnabled()

Параметры

Нет.

Описание

javaEnabled возвратите true, если Java доступен; иначе, flase. Пользователь может включать или отключать Java через свойства пользователя.

Примеры

Следующий код выполняет function1, если Java доступен; иначе, выполняет function2.

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

Смотрите также

navigator.appCodeName, navigator.appName, navigator.userAgent

preference

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

Метод объекта navigator
Статический
Реализовано в Navigator 4.0

Синтаксис

preference(prefName)
preference(prefName, setValue)

Параметры

prefName
Строка, представляющая имя свойства, которое Вы хотите получить или установить. Допустимые свойства перечислены ниже.
setValue
Значение, которое Вы хотите присвоить свойству. Это может быть строка, число или Буль.

Описание

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

Защита

При чтении свойства методом preference требуется привилегия UniversalPreferencesRead. Установка свойства этим методом требует привилегию UniversalPreferencesWrite.

Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

С разрешением, Вы можете получать и устанавливать предпочтения, показанные в Таблице 8.2.

Таблица 8.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
Принимать все файлы cookie
network.cookie.cookieBehavior
0
Принимать только файлы cookie, которые будут посланы обратно серверу
network.cookie.cookieBehavior
1
Отключить cookies
network.cookie.cookieBehavior
2
Предупреждение перед принятием файла cookie
network.cookie.warnAboutCookies
true или false

taintEnabled

Определяет, доступно ли заражение данных.

Метод объекта navigator
Статическое
Реализовано в Navigator 3.0; удалено в Navigator 4.0

Синтаксис

navigator.taintEnabled()

Описание

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

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

Примеры

Следующий код выполняет function1, если заражение данных доступно; иначе он выполняет function2.

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

Смотрите также

taint, untaint


[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:32:33


Права © 1997 Netscape Communications Corporation



Все мессаги сюда:yanich@inbox.ru
Hosted by uCoz