Viewing version 2.4.3. Open the latest package page.

url_launcher_web

2.4.3

Web platform implementation of url_launcher

Readme

url_launcher_web

The web implementation of url_launcher.

Usage

This package is endorsed, which means you can simply use url_launcher normally. This package will be automatically included in your app when you do, so you do not need to add it to your pubspec.yaml.

However, if you import this package to use any of its APIs directly, you should add it to your pubspec.yaml as usual.

Limitations on the Web platform

A launch needs to be triggered by a user action

Web browsers prevent launching URLs in a new tab/window, unless triggered by a user action (e.g. a button click).

Even if a user triggers a launch through a button click, if there is a delay due to awaiting a Future before the launch, the browser may still block it. This is because the browser might perceive the launch as not being a direct result of user interaction, particularly if the Future takes too long to complete.

In such cases, you can use the webOnlyWindowName parameter, setting it to _self, to open the URL within the current tab. Another approach is to ensure that the uri is synchronously ready.

Method `launchUrl` always returns `true` for allowed schemes

The launchUrl method always returns true on the web platform for allowed schemes. This is because URLs are opened in a new window using the noopener window feature. When the noopener feature is used, the browser does not return any information that can be used to determine if the link was successfully opened.

2.4.3

Removes a LICENSE entry for code that no longer exists in the package.

2.4.2

Fixes an issue that caused duplicate semantic nodes for Link widgets.
Updates minimum supported SDK version to Flutter 3.32/Dart 3.8.

2.4.1

Fixes a bug that triggers Links when they are not supposed to.

2.4.0

Enhances handling of out-of-order events.
Adds support for clicks with a modifier key (e.g. cmd+click).
Improves support for semantics.
Applies the target attribute to semantic links.
Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.

2.3.3

Changes launchUrl so it always returns true, except for disallowed URL schemes.

2.3.2

Adds support for web: ^1.0.0.

2.3.1

Implements correct handling of keyboard events with Link.

2.3.0

Updates web code to package web: ^0.5.0.
Updates SDK version to Dart ^3.3.0. Flutter ^3.19.0.

2.2.3

Fixes new lint warnings.

2.2.2

Adds documentation that a launch in a new window/tab needs to be triggered by a user action.

2.2.1

Supports Flutter Web + Wasm
Updates minimum supported SDK version to Flutter 3.16.0/Dart 3.2.0.

2.2.0

Implements supportsMode and supportsCloseForMode.

2.1.0

Adds launchUrl implementation.
Prevents Tabnabbing and disallows javascript: URLs on launch and launchUrl.

2.0.20

Migrates to dart:ui_web APIs.
Updates minimum supported SDK version to Flutter 3.13.0/Dart 3.1.0.

2.0.19

Adds pub topics to package metadata.
Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.

2.0.18

Removes nested third_party Safari check.

2.0.17

Removes obsolete null checks on non-nullable values.
Updates minimum Flutter version to 3.3.

2.0.16

Clarifies explanation of endorsement in README.
Aligns Dart and Flutter SDK constraints.

2.0.15

Updates links for the merge of flutter/plugins into flutter/packages.
Updates minimum Flutter version to 3.0.

2.0.14

Updates code for stricter lint checks.
Updates minimum Flutter version to 2.10.

2.0.13

Updates url_launcher_platform_interface constraint to the correct minimum version.

2.0.12

Fixes call to setState after dispose on the Link widget. Issue.
Removes unused BuildContext from the LinkViewController.

2.0.11

Minor fixes for new analysis options.

2.0.10

Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors lint warnings.

2.0.9

Fixes invalid routes when opening a Link in a new tab

2.0.8

Updates the minimum Flutter version to 2.10, which is required by the change in 2.0.7.

2.0.7

Marks the Link widget as invisible so it can be optimized by the engine.

2.0.6

Removes dependency on meta.

2.0.5

Updates code for new analysis options.

2.0.4

Add implements to pubspec.

2.0.3

Replaced reference to shared_preferences plugin with the url_launcher in the README.

2.0.2

Updated installation instructions in README.

2.0.1

Change sizing code of Link widget's HtmlElementView so it works well when slotted.

2.0.0

Migrate to null safety.

0.1.5+3

Fix Link misalignment issue.

0.1.5+2

Update Flutter SDK constraint.

0.1.5+1

Substitute undefined_prefixed_name: ignore analyzer setting by a dart:ui shim with conditional exports. Issue.

0.1.5

Added the web implementation of the Link widget.

0.1.4+2

Move lib/third_party to lib/src/third_party.

0.1.4+1

Add a more correct attribution to package:platform_detect code.

0.1.4

(Null safety) Remove dependency on package:platform_detect
Port unit tests to run with flutter drive

0.1.3+2

Fix a typo in a test name and fix some style inconsistencies.

0.1.3+1

Depend explicitly on the platform_interface package that adds the webOnlyWindowName parameter.

0.1.3

Added webOnlyWindowName parameter to launch()

0.1.2+1

Update docs

0.1.2

Adds "tel" and "sms" support

0.1.1+6

Open "mailto" urls with target set as "_top" on Safari browsers.
Update lower bound of dart dependency to 2.2.0.

0.1.1+5

Update lower bound of dart dependency to 2.1.0.

0.1.1+4

Declare API stability and compatibility with 1.0.0 (more details at: https://github.com/flutter/flutter/wiki/Package-migration-to-1.0.0).

0.1.1+3

Refactor tests to not rely on the underlying browser behavior.

0.1.1+2

Open urls with target "_top" on iOS PWAs.

0.1.1+1

Make the pedantic dev_dependency explicit.

0.1.1

Added support for mailto scheme

0.1.0+2

Remove androidx references from the no-op android implemenation.

0.1.0+1

Add an android/ folder with no-op implementation to workaround https://github.com/flutter/flutter/issues/46304.
Bump the minimal required Flutter version to 1.10.0.

0.1.0

Update docs and pubspec.

0.0.2

Switch to using url_launcher_platform_interface.

0.0.1

Initial open-source release.

Installing

export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com
flutter pub add 'url_launcher_web:2.4.3'

pubspec.yaml

name: url_launcher_web
description: Web platform implementation of url_launcher
repository: https://github.com/flutter/packages/tree/main/packages/url_launcher/url_launcher_web
issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+url_launcher%22
version: 2.4.3

environment:
  sdk: ^3.10.0
  flutter: ">=3.38.0"

flutter:
  plugin:
    implements: url_launcher
    platforms:
      web:
        pluginClass: UrlLauncherPlugin
        fileName: url_launcher_web.dart

dependencies:
  flutter:
    sdk: flutter
  flutter_web_plugins:
    sdk: flutter
  url_launcher_platform_interface: ^2.2.0
  web: ">=0.5.1 <2.0.0"

dev_dependencies:
  flutter_test:
    sdk: flutter

topics:
  - links
  - os-integration
  - url-launcher
  - urls

Version history

Version	Published	Archive	SHA-256
0.0.2	2019-11-19On demand	Download	`7eee7977…4e742d`
0.1.0	2019-11-19On demand	Download	`0dfae9eb…b67771`
0.1.0+1	2019-12-09On demand	Download	`307f073d…c4f6f3`
0.1.0+2	2019-12-12On demand	Download	`db91714d…5f6210`
0.1.1	2020-02-06On demand	Download	`ea247540…04996f`
0.1.1+1	2020-02-20On demand	Download	`5d42ce19…f30513`
0.1.1+2	2020-04-23On demand	Download	`e6c3d26a…51bb69`
0.1.1+4	2020-05-06On demand	Download	`254131d3…e974ed`
0.1.1+5	2020-05-12On demand	Download	`910b391e…7c54ff`
0.1.1+6	2020-05-19On demand	Download	`723a89a1…bda79e`
0.1.2	2020-06-30On demand	Download	`09a6f9e1…e7eeef`
0.1.2+1	2020-08-14On demand	Download	`a63c10b2…6176d6`
0.1.3	2020-08-28On demand	Download	`b7478fa6…559043`
0.1.3+1	2020-08-31On demand	Download	`a591a219…6c1be7`
0.1.3+2	2020-09-10On demand	Download	`8d7b48ca…73016d`
0.1.4+1	2020-09-23On demand	Download	`1a6f8a03…782857`
0.1.5	2020-10-20On demand	Download	`36f97f5a…8ced2c`
0.1.5+1	2020-11-05On demand	Download	`8672efbe…76b299`
0.1.5+3	2021-01-29On demand	Download	`eaa6de8a…83dbc2`
2.0.0-nullsafety	2021-02-16On demand	Download	`25e457dc…5cea0a`
2.0.0	2021-02-22On demand	Download	`057e3458…c0f657`
2.0.1	2021-06-01On demand	Download	`c664a85a…192754`
2.0.2	2021-07-27On demand	Download	`98f7b59f…fe32bd`
2.0.4	2021-08-20On demand	Download	`a2bc64b5…0d323e`
2.0.5	2021-11-30On demand	Download	`53be6a00…81862a`
2.0.6	2022-01-10On demand	Download	`88de707c…085850`
2.0.7	2022-02-04On demand	Download	`d486afa4…3e7326`
2.0.8	2022-02-05On demand	Download	`6699ef5a…493964`
2.0.9	2022-02-25On demand	Download	`2b549472…28d97f`
2.0.10	2022-05-10On demand	Download	`141c1035…3b9dc9`
2.0.11	2022-05-11On demand	Download	`1c7d34f9…6e9abe`
2.0.12	2022-06-15On demand	Download	`15fd9dbb…800deb`
2.0.13	2022-08-05On demand	Download	`56698826…07df2a`
2.0.14	2023-01-20On demand	Download	`44d79408…19ccb0`
2.0.15	2023-02-22On demand	Download	`574cfbe2…69dd9b`
2.0.16	2023-03-08On demand	Download	`81fe91b6…28f1aa`
2.0.17	2023-05-22On demand	Download	`6bb1e5d7…5cfcab`
2.0.18	2023-07-06On demand	Download	`cc26720e…a5cbb4`
2.0.19	2023-08-30On demand	Download	`ba140138…cd94f2`
2.0.20	2023-08-30On demand	Download	`2942294a…020ce5`
2.1.0	2023-10-23On demand	Download	`043a0d5b…f56d17`
2.2.0	2023-10-24On demand	Download	`7fd2f55f…718bb2`
2.2.1	2023-11-21On demand	Download	`138bd45b…851cf7`
2.2.2	2023-12-08On demand	Download	`7286aec0…a358e9`
2.2.3	2024-01-04On demand	Download	`fff09321…a5e88b`
2.3.0	2024-02-20On demand	Download	`3692a459…1a901d`
2.3.1	2024-04-15On demand	Download	`8d9e750d…e95d8a`
2.3.2	2024-08-01On demand	Download	`a36e2d79…98d049`
2.3.3	2024-08-06On demand	Download	`772638d3…3dca8e`
2.4.0	2025-01-10On demand	Download	`3ba96316…85f1e9`
2.4.1	2025-04-24On demand	Download	`4bd2b7b4…3abba2`
2.4.2	2026-01-15On demand	Download	`d0412fcf…476c1f`
2.4.3	2026-05-05Cached · Upstream SHA-256 matched	Download	`85c81589…9ddb34`

Dependencies

flutter { "sdk": "flutter" }

flutter_web_plugins { "sdk": "flutter" }

url_launcher_platform_interface "^2.2.0"

web "\u003e=0.5.1 \u003c2.0.0"

Selected archive

2.4.3

85c81589622fbc87c1c683aaea164d3604a7777495a79d91e39ffcdec39ddb34

Cached · Upstream SHA-256 matched

53 published versions

url_launcher_web

Readme

url_launcher_web

Usage

Limitations on the Web platform

A launch needs to be triggered by a user action

Method launchUrl always returns true for allowed schemes

2.4.3

2.4.2

2.4.1

2.4.0

2.3.3

2.3.2

2.3.1

2.3.0

2.2.3

2.2.2

2.2.1

2.2.0

2.1.0

2.0.20

2.0.19

2.0.18

2.0.17

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

0.1.5+3

0.1.5+2

0.1.5+1

0.1.5

0.1.4+2

0.1.4+1

0.1.4

0.1.3+2

0.1.3+1

0.1.3

0.1.2+1

0.1.2

0.1.1+6

0.1.1+5

0.1.1+4

0.1.1+3

0.1.1+2

0.1.1+1

0.1.1

0.1.0+2

0.1.0+1

0.1.0

0.0.2

0.0.1

Installing

Version history

Dependencies

Method `launchUrl` always returns `true` for allowed schemes