Flutter WebView での JavaScript から Dart への通信の処理
ハイブリッド アプリケーションを組み立てるには、WebView を介して JavaScript と Flutter を統合することが必要になる場合があります。 JavaScript から Dart へのデータ送信は、2 つの環境間のスムーズな通信を可能にする頻繁なジョブの 1 つです。
この投稿では、Flutter WebView プラグインの JavaScript チャネルを使用して、JavaScript から Dart に多数のパラメーターを転送する方法を説明します。特に、2 つの引数が存在する状況に焦点を当てます。 × そして y、を使用する JavaScript 関数によって Dart に送信されます。 セット位置 チャネル。
を使用してJavaScriptからデータを送信できますが、 postMessage()、通信が意図したとおりに機能することを保証するには、Dart でこれらのメッセージを正しく処理することが不可欠です。効果的なデータ処理には、Dart の使用方法を知る必要があります。 onメッセージ受信済み これを行うための関数です。
インターネットで答えを検索しようとしたものの、あまり見つからなかったとしても、あなたは一人ではありません。この記事では、この通信パイプラインを構築するための段階的な方法を詳しく説明します。
指示 | 使用例 |
---|---|
postMessage() | この JavaScript メソッドの目的は、複数のコンテキスト間でメッセージを転送することです。ここでは、経由でデータを転送するために使用されます。 JavaScript チャネル Web コンテンツ (この例では JavaScript) から Flutter WebView の Dart 側に送信します。 |
jsonDecode() | JSON でエンコードされた文字列を解析し、それを Dart マップまたはリストに変換する Dart 関数は、dart:convert パッケージにあります。のようなデータを取得するには × そして y、デコードを支援します。 JSONメッセージ JavaScriptから受け取ります。 |
JavascriptChannel | これは、Dart コードと WebView 内で実行される JavaScript 間の通信を容易にする Flutter クラスです。 JavaScript 側からメッセージが到着すると、 JavaScriptチャンネル それらをリッスンし、Dart で処理します。 |
onMessageReceived | でトリガーされるコールバック JavaScriptチャンネル JavaScript からメッセージを受信したとき。受信メッセージを管理し、JSON の解析や指定された引数の使用などのデータ処理操作を実行します。 |
navigationDelegate | Dart プロパティにより、 WebView ナビゲーションに関連するイベントを制御およびインターセプトするウィジェット。これにより、URL の変更を記録できるようになります (カスタム URL スキームを使用してパラメータを送信する場合など)。 |
Uri.queryParameters | Dart では、このプロパティは URL からクエリ パラメータを取得します。 URL のパラメータとして指定されたデータにアクセスできます。 × そして y、カスタム URL スキームを使用する場合。 |
NavigationDecision.prevent | 戻り値 ナビゲーションデリゲート WebView のナビゲーションを停止するために使用します。現在のページを離れることなく引数を管理し、URL の変更をインターセプトする場合に役立ちます。 |
JavascriptMessage | 経由で送信されたメッセージを受信する Dart クラス JavaScriptチャンネル JavaScriptからDartまで。メッセージ文字列がそこに含まれており、必要に応じて処理またはデコードできるようになります。 |
WebView | の WebView Flutter アプリのウィジェットは、Web コンテンツを表示するために使用されます。これにより、JavaScript チャネルにアクセスできるようになり、ネイティブ コードと Web コード間の双方向通信が可能になります。 |
Flutter WebView での JavaScript と Dart 通信の統合
私たちが開発したソリューションは、 JavaScript チャネル ~から多数の引数を送信する JavaScript Flutter の WebView 経由で Dart に接続します。主な目標は、Dart コードと WebView で実行される JavaScript 間の通信のための信頼できるパイプラインを作成することです。の postMessage() このメソッドは 2 つのパラメータ (x と y) を送信するために JavaScript 関数によって使用され、これらのパラメータはその後 onMessageReceived コールバックを介して Dart によって受信されます。この構成により、重要な情報が Web コンテンツからネイティブの Dart コードに効果的に伝達されます。
を使用して、 jsonDecode() 関数では、受信したメッセージを Dart 側でデコードします。 JavaScript から JSON データを転送することで、多数のパラメーターを体系的に送信できるようにします。デコード後、Dart は個々の値 (x と y) を取得し、それらをあらゆる目的に使用できます。これには、情報の記録、ユーザー インターフェイス要素の変更、取得した値に依存するその他のタスクの実行が含まれます。このメソッドは、複雑なデータ構造を JavaScript から Dart に送信する際に、低いオーバーヘッドを保証します。
メッセージを直接管理する以外に、独自の URL スキームを利用する別のアプローチも検討しました。を変更することで、URL 経由でパラメータを送信できます。 window.location.href JavaScriptで。 Dart は、次のコマンドを使用してこのデータを傍受できます。 ナビゲーションデリゲート。を使用するときは、 JavaScript チャネル 実現不可能な場合や、プログラムの設計を考慮すると URL ベースの通信の方が合理的である場合には、このアプローチが役立つことがあります。その後、Dart は URL を解析し、 Uri.queryパラメータ x や y などのパラメータを抽出する関数。これにより、Dart と Web コンテンツ間のいくつかの通信メカニズムが可能であることが保証されます。
すべてのアプローチにおいて、特に着信通信を受信する場合には、パフォーマンスとセキュリティが最優先されます。メッセージパッシングに JSON を採用することでプロセスの安全性と可読性が向上し、データ操作が阻止されます。単体テストでは、機能がさまざまな設定で意図したとおりに機能することも保証します。スムーズで信頼性の高い、 WebView 統合により、Web テクノロジーと Flutter のネイティブ環境の間に強力なリンクが作成されます。
Flutter WebView を介して JavaScript から Dart に複数のパラメータを渡す
このソリューションは、ベスト プラクティスに従って処理しながら、JavaScript から Dart にいくつかの引数 (x、y) を渡します。これは、Flutter WebView プラグインと JavaScript チャネルを利用して行われます。
// JavaScript code to send two parameters to Dart
function sendPosition(x, y) {
setPosition.postMessage(JSON.stringify({ x: x, y: y }));
}
// Example of calling the function
sendPosition(100, 200);
WebView の JavaScript チャネル経由で Dart で受け取ったパラメータを処理する
この Dart ソリューションの主な目的は、受信したメッセージを JSON 形式でデコードすることで、WebView の JavaScript チャネル経由で効果的に処理することです。
// Dart code: Set up WebView and JavaScript channel
WebView(
initialUrl: 'https://your-webpage.com',
javascriptChannels: {
JavascriptChannel(
name: 'setPosition',
onMessageReceived: (JavascriptMessage message) {
// Decode the JSON message
final data = jsonDecode(message.message);
final x = data['x'];
final y = data['y'];
// Handle the x and y values
print('Position received: x=$x, y=$y');
// Add your logic here
},
),
},
);
Dart の単体テスト: JavaScript チャネルのテスト
ソリューションの単体テストの Dart 側では、JavaScript メッセージが正しく処理および解析されることを確認します。
import 'package:flutter_test/flutter_test.dart';
import 'dart:convert';
void main() {
test('Test JavaScript message parsing', () {
const message = '{"x": 100, "y": 200}';
final data = jsonDecode(message);
expect(data['x'], 100);
expect(data['y'], 200);
});
}
代替アプローチ: URL スキームを使用したパラメータの受け渡し
このメソッドは、WebView の URL 変更イベント時に Dart でデコードされる JavaScript のカスタム URL スキームを使用して引数を渡す方法を示します。
// JavaScript code: Send parameters via custom URL scheme
function sendPositionViaUrl(x, y) {
window.location.href = 'flutter-webview://setPosition?x=' + x + '&y=' + y;
}
// Example of calling the function
sendPositionViaUrl(100, 200);
Dart: WebView での URL 変更の処理
URL プロトコル経由で指定されたパラメーターをキャプチャして処理するために、この Dart ソリューションは WebView での URL の変更をインターセプトします。
WebView(
initialUrl: 'https://your-webpage.com',
navigationDelegate: (NavigationRequest request) {
if (request.url.startsWith('flutter-webview://setPosition')) {
final uri = Uri.parse(request.url);
final x = uri.queryParameters['x'];
final y = uri.queryParameters['y'];
print('Position received via URL: x=$x, y=$y');
// Add your logic here
return NavigationDecision.prevent;
}
return NavigationDecision.navigate;
},
);
Flutter WebView でのパラメータ受け渡しテクニックの探索
より複雑なデータ構造の処理は、JavaScript と Dart の間で Flutter WebView を介して受け渡すパラメーターの重要な部分です。私たちは基礎に合格することに焦点を当ててきましたが、 × そして y 引数に加えて、オブジェクト、配列、または複数のネストされたオブジェクトも渡す必要がある場合があります。複雑なデータ構造は、JavaScript を使用して文字列形式に変換できます。 JSON.stringify() メソッドを使用して効果的に転送できます。 postMessage() 方法。その後、Dart が利用できるようになります jsonDecode() 処理できるように初期構造を再組み立てします。
メッセージ転送エラー管理も実用的な方法です。重要なデータを 2 つの言語間で移動する場合、データが JavaScript 環境と Dart 環境の両方で検証されていることを確認することが重要です。呼び出す前にチェックを入れることで、不正なデータの配信を回避できます。 postMessage() JavaScript側で。エンコードされたデータを検証することで、Dart 側で予期されたキーと値が含まれていることを確認できます。これにより、効果的な通信が保証されるだけでなく、間違いやデータの破損も防止されます。
さらに、 WebView Flutter では、Web ページにカスタム JavaScript を適用できる追加機能が提供されます。を利用することで、Dart 側から JavaScript ルーチンを動的にトリガーできます。 evaluateJavascript 技術。これにより、Flutter アプリから Web コンテンツにコマンドを送信できるようになり、双方向の通信チャネルが強化され、汎用性が高まります。 2 つの層間で継続的にデータを交換する必要がある場合、この戦略はうまく機能します。
Flutter WebView でのパラメータの受け渡しに関するよくある質問
- 複雑なオブジェクトを JavaScript から Dart に送信するにはどうすればよいですか?
- Dart 側で複雑なオブジェクトをデコードするには、次を使用します。 jsonDecode() それらを文字列に変換した後、 JSON.stringify() そして postMessage()。
- データを転送する前に最も効果的に検証するにはどうすればよいでしょうか?
- データを送信する前に、 postMessage()正しく構造化されており、JavaScript 側に必要なフィールドがすべて含まれていることを確認してください。通信がデコードされたら、Dart 側のキーと値を確認します。
- JavaScript から Dart に 3 つ以上のパラメータを送信することはできますか?
- はい、使用できます JSON.stringify() 多くのパラメータを JSON オブジェクトとして送信し、 jsonDecode() Dart でそれらを処理します。
- WebView が JavaScript チャネルをサポートしていない場合はどうなりますか?
- JavaScript チャネルが利用できない場合は、カスタム URL スキームを使用して、 navigationDelegate Dart で URL をインターセプトします。
- パラメーターの受け渡し中のエラーはどのように処理すればよいですか?
- Dart と JavaScript でエラー処理を実践します。すべてのデータが送信されたことを確認してください postMessage() にチェックが入っているので使用します try-catch Dart のブロックを使用してデコードの問題を検出します。
Flutter WebView 通信に関する最終的な考え
JavaScript と Dart の間で引数を送信できる機能により、オンライン コンテンツと Flutter アプリの対話方法が改善されます。データの整合性と使いやすさが保証されるのは、 postMessage() ダーツと組み合わせて使用されます jsonDecode() 関数。
開発者は、URL スキームやダイレクト メッセージの処理などのいくつかの戦略を検討することで、プロジェクトに最適なアプローチを選択できます。適切な検証とエラー管理を確保することで、これらの通信システムの信頼性が向上します。
Flutter WebView での JavaScript から Dart への通信に関するリファレンスとリソース
- セットアップについて詳しく説明します JavaScript チャネル そしてそれらがどのように統合されるか Flutter WebView アプリケーション。 Flutter WebView ドキュメント
- についての洞察を提供します。 postMessage() メソッドと、クロスフレーム メッセージングのための JavaScript でのその使用法について説明します。 MDN Web ドキュメント - postMessage()
- Dart が JavaScript から効率的にデータを処理するために JSON デコードと解析を処理する方法について説明します。 Dart jsonDecode() ドキュメント
- を使用してカバーします。 ナビゲーションデリゲート WebView 内の URL インターセプト用。 Flutter WebView NavigationDelegate