Web/JavaScriptエージェント
📄️ クイックスタート
このクイックスタートガイドでNetFUNNEL 4 JavaScriptエージェントを5-10分以内に開始して実行してください。
📄️ インストールおよび初期化
このガイドはURLトリガー統合とコードベース統合方法の両方に適用される必須設定ステップを扱います。
🗃️ 統合方法
2項目
📄️ 初期化オプションリファレンス
NetFUNNEL JavaScriptエージェントのすべての構成オプション(data-attributes)の完全な参照です。
📄️ APIリファレンス
NetFUNNEL JavaScriptエージェント関数、コールバック、応答形式の完全な参照です。
📄️ トラブルシューティング
NetFUNNEL JavaScriptエージェント統合に関する一般的な問題、解決方法、よくある質問です。
概要
JavaScriptエージェントは、WebアプリケーションにNetFUNNEL 4トラフィック制御機能を提供するクライアント側SDKです。Webページに直接統合され、キュー管理および待合室機能を実装し、サーバー負荷を分散し、トラフィックが多い期間中に安定したユーザー体験を保証します。
主要機能
- クライアント側SDK: シンプルなJavaScript API呼び出しでWebページに直接統合
- 2つの統合方法: URLトリガー統合(コードなし)とコードベース統合(精密制御)から選択
- 柔軟な制御: ページレベル保護のためのURLトリガー、ボタン/APIレベル制御のためのコードベース
- ネイティブ待合室: カスタムUIオプション付きWebViewベースの待合室テンプレート
- リアルタイムキュー更新: リアルタイムキュー位置、待機時間、進行情報を受信
- ネットワーク回復: ネットワーク問題から自動回復してユーザー体験を維持
- 強力なエラー処理: スマートエラー処理戦略を備えた包括的なコールバックシステム
- 軽量SDK: バニラJavaScriptサポートで最小限の依存関係
- クロスブラウザ互換性: すべての最新ブラウザおよびフレームワークで動作
システム要件
- ブラウザ: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
- JavaScript: ES6+サポートが必要
- フレームワーク: React、Vue、Angular、バニラJavaScriptなどと互換
- HTTPS: 本番環境で必要
互換環境
- Webアプリケーション: シングルページアプリケーション(SPA)、マルチページアプリケーション(MPA)、プログレッシブWebアプリ(PWA)
- フレームワーク: React、Vue.js、Angular、Next.js、Nuxt.js、バニラJavaScript
- すべてのWebプラットフォーム: デスクトップブラウザ、モバイルブラウザ、埋め込みWebView
動作方法
JavaScript SDKはWebアプリケーションとシームレスに統合されます:
- SDK初期化: NetFUNNELスクリプトを含めて構成で初期化
- 統合選択: URLトリガー統合(自動)またはコードベース統合(手動制御)を使用
- WebView待合室: SDKがWebViewベースの待合室を表示(デフォルトテンプレートまたはカスタムUI)
- ユーザー体験: ウェブサイトデザインおよびフローとのシームレスな統合
統合方法の例
URLトリガー統合フロー:
ユーザーがURL訪問 → 自動確認 → 待合室(必要な場合) → 元のページ
コードベース統合フロー:
ユーザー作業 → nfStart() → 待合室 → onSuccess() → ユーザー進行 → nfStop()
統合方法
1. URLトリガー統合
- 最適な用途: ページレベル保護、ランディングページ、プロモーション
- 設定: コンソールでトリガールール構成(コード変更なし)
- ユーザー体験: 待合室に自動リダイレクト後、ターゲットページに戻る
- 制御レベル: ページベースのトラフィック制御
2. コードベース統合
- 最適な用途: ボタンクリック、API呼び出し、精密制御
- 設定: JavaScriptコードからNetFUNNEL関数を呼び出す
- ユーザー体験: 現在の画面にモーダル待合室
- 制御レベル: 作業ベースのトラフィック制御
重要な制限事項
モバイルアプリの考慮事項
- ネイティブモバイルアプリ: このSDKはネイティブモバイルアプリ環境(Android/iOSネイティブコード)では動作しません
- ネイティブモバイルアプリ: ネイティブモバイルアプリのトラフィック制御の場合は、代わりにAndroidエージェントまたはiOSエージェントを使用してください
はじめに
JavaScriptエージェントを迅速に開始するには、クイックスタートガイドを参照してください。
練習プロジェクト利用可能
練習用の基本プロジェクトが必要ですか? NetFUNNEL JavaScriptエージェント統合の練習のために準備された**Webアプリケーション(バニラJavaScript MPA)**テンプレートを含むサンプルプロジェクトを確認してください。
ドキュメント
コアドキュメント
- クイックスタート: 基本例で5-10分以内に開始
- インストールおよび初期化: 依存関係および構成を含む詳細設定ガイド
- 統合方法: URLトリガー vs コードベースアプローチの比較
- APIリファレンス: 完全な関数仕様、コールバック、応答形式
- 初期化オプションリファレンス: すべての初期化パラメータおよび使用方法
- トラブルシューティング: 一般的な問題、解決方法、FAQ
実装ガイド
関連コンテンツ
- Androidエージェント: Android SDK統合ガイド
- iOSエージェント: iOS SDK統合ガイド
- サンプルプロジェクト: すぐに使用できるプロジェクトテンプレート