launchUrlString function

Future<bool> launchUrlString(String urlString, { LaunchMode mode = LaunchMode.platformDefault, WebViewConfiguration webViewConfiguration = const WebViewConfiguration(), String? webOnlyWindowName, String? webOnlyOptions, })

String version of launchUrl.

This should be used only in the very rare case of needing to launch a URL that is considered valid by the host platform, but not by Dart's Uri class. In all other cases, use launchUrl instead, as that will ensure that you are providing a valid URL.

The behavior of this method when passing an invalid URL is entirely platform-specific; no effort is made by the plugin to make the URL valid. Some platforms may provide best-effort interpretation of an invalid URL, others will immediately fail if the URL can't be parsed according to the official standards that define URL formats.

Implementation

Future<bool> launchUrlString(
  String urlString, {
  LaunchMode mode = LaunchMode.platformDefault,
  WebViewConfiguration webViewConfiguration = const WebViewConfiguration(),
  String? webOnlyWindowName,
  String? webOnlyOptions,
}) async {
  if (mode == LaunchMode.inAppWebView &&
      !(urlString.startsWith('https:') || urlString.startsWith('http:'))) {
    throw ArgumentError.value(urlString, 'urlString',
        'To use an in-app web view, you must provide an http(s) URL.');
  }
  return UrlLauncherPlatform.instance.launchUrl(
    urlString,
    LaunchOptions(
      mode: convertLaunchMode(mode),
      webViewConfiguration: convertConfiguration(webViewConfiguration),
      webOnlyWindowName: webOnlyWindowName,
      webOnlyOptions: webOnlyOptions,
    ),
  );
}