Edition for Web Developers — Last Updated 14 January 2025
Navigator
オブジェクトSupport in all current engines.
Navigator
のインスタンスは、ユーザーエージェント(クライアント)のIDと状態を表す。It has also been used as a generic global under which various APIs are located, but this is not precedent to build upon. Instead use the WindowOrWorkerGlobalScope
mixin or equivalent.
特定の場合において、業界全体の最善の努力にもかかわらず、ウェブブラウザーは、ウェブ著者が回避することを余儀なくされるバグや限界がある。
このセクションは、スクリプトから使用中のユーザーエージェントの種類を判断するために使用できる属性の集合を定義し、順番にこれらの問題を回避する。
クライアント検出は常に既知の現行バージョンの検出に限定されるべきである。将来のバージョンおよび未知のバージョンは、常に完全に準拠するよう仮定されるべきである。
self.navigator.
文字列"Mozilla
"を返す。
self.navigator.
文字列"Netscape
"を返す。
self.navigator.
ブラウザーのバージョンを返す。
self.navigator.
プラットフォームの名前を返す。
self.navigator.
文字列"Gecko
"を返す。
window.navigator.
文字列"20030107
"または文字列"20100101
"のいずれかを返す。
self.navigator.
完全な`User-Agent
`ヘッダーを返す。
window.navigator.
空文字列、文字列"Apple Computer, Inc.
"、または文字列"Google Inc.
"のいずれかを返す。
window.navigator.
空文字列を返す。
self.navigator.
ユーザーの優先言語を表す言語タグを返す。
self.navigator.
ユーザーの優先言語を表す言語タグの配列を返す。
最も優先される言語は、navigator.language
によって返されるものである。
どのユーザーの優先言語かユーザーエージェントの理解が変更する場合、languagechange
イベントは、Window
またはWorkerGlobalScope
オブジェクトで発火する。
self.navigator.
ユーザーエージェントが正確にオフラインである(ネットワークから切断されている)場合にfalseを返すユーザーエージェントがオンラインかもしれない場合にtrueを返す。
この属性は、本質的に信頼できない。コンピューターは、インターネット接続がなくてもネットワークに接続できる。
この例において、ブラウザーがオンラインおよびオフラインになるように、インジケーターが更新される。
<!DOCTYPE HTML>
< html lang = "en" >
< head >
< title > Online status</ title >
< script >
function updateIndicator() {
document. getElementById( 'indicator' ). textContent = navigator. onLine ? 'online' : 'offline' ;
}
</ script >
</ head >
< body onload = "updateIndicator()" ononline = "updateIndicator()" onoffline = "updateIndicator()" >
< p > The network is: < span id = "indicator" > (state unknown)</ span >
</ body >
</ html >
registerProtocolHandler()
メソッドNavigator/registerProtocolHandler
window.navigator. (scheme, url)
schemeのハンドラーをurlに登録する。たとえば、オンライン電話メッセージングサービスは、それ自体をsms:
スキームのハンドラーとして登録できるため、ユーザーがそのようなリンクをクリックする場合に、そのウェブサイトを使用する機会が与えられる。[SMS]
url内文字列"%s
"は、扱うにあたりコンテンツのURLをどこに置くかのプレースホルダーとして使用される。
ユーザーエージェントが登録をブロックする場合、"SecurityError
" DOMException
を投げる(これは、たとえば"http
"のハンドラーとして登録しようとした場合に発生する可能性がある)。
"%s
"文字列がurlにない場合、"SyntaxError
" DOMException
を投げる。
window.navigator. (scheme, url)
引数で指定されたハンドラーの登録を解除する。
ユーザーエージェントが登録解除をブロックする場合、"SecurityError
" DOMException
を投げる(これは、たとえば、不正なスキームの場合に発生する可能性がある)。
"%s
"文字列がurlにない場合、"SyntaxError
" DOMException
を投げる。
window.navigator.
クッキーの設定が拒否される場合falseを返し、そうでなければtrueを返す。
window.navigator.
Support in all current engines.
ユーザーエージェントがPDFファイルにナビゲートするときにPDFファイルのインライン表示をサポートしている場合はtrueを返し、そうでなければfalseを返す。後者の場合、PDFファイルは外部ソフトウェアによって処理される。