SHD / MC Checker

MC1449170 | Microsoft Edge: Retirement of default unload event support



MC1449170 | Microsoft Edge: Retirement of default unload event support

Classification planForChange
Last Updated 08/06/2026 22:48:08
Start Time 08/06/2026 22:47:52
End Time 12/01/2026 08:00:00
Action Required By Date 2026-09-05T07:00:00Z
Message Content

If your websites or applications do not use unload event handlers (unload), the impact described below does not apply and no action is required.

[What and why]

Microsoft Edge is changing the default behavior of the web platform unload event as part of the ongoing retirement of unload event handlers.

Today, unload event handlers are allowed by default. As this change rolls out, pages will no longer run unload event handlers unless the site explicitly permits them through Permissions Policy. Organizations should work with application owners to migrate their applications to modern lifecycle events and APIs designed for these scenarios.

The unload event is not a reliable way to save data, perform cleanup operations, or indicate that a user session has ended because browsers and operating systems can suspend or terminate pages without firing it. It can also prevent pages from using the back/forward cache, which may affect navigation performance.

[Rollout schedule]

  • Worldwide, GCC, GCC High, DoD: Beginning in early September 2026 and expected to complete in October 2026

[Impact on your organization]

Who is affected

Organizations may be affected if internal websites, public websites, or third-party web applications that users depend on use unload event handlers to provide required functionality.

Users are affected only when a website or application depends on unload event handlers and does not provide an alternative implementation.

Platforms and services

  • Microsoft Edge
  • Websites and web applications opened in Microsoft Edge
  • WebView2-based applications
  • Managed Microsoft Edge environments

What will happen

Websites and applications that rely on unload event handlers may experience functional changes when the handlers no longer run by default.

Common scenarios include applications that use unload handlers to:

  • Save user data
  • Release resources
  • Send analytics or telemetry
  • Notify services that a session has ended

Organizations can temporarily preserve the current behavior while applications are updated by enabling the ForcePermissionPolicyUnloadDefaultEnabled Microsoft Edge policy. This policy is intended only as a migration aid while application owners update affected applications. A website can still apply a more restrictive Permissions Policy configuration.

[Action required and recommendations]

Complete the following actions by September 6,2026:

  • Identify internal and business-critical web applications that register unload event handlers, including handlers introduced through third-party libraries.
  • Validate application behavior without relying on unload event handlers.
  • Use Microsoft Edge DevTools to identify pages that are blocked from using the back/forward cache because of unload listeners.
  • Migrate data-saving scenarios to the visibilitychange event and use transitions to the hidden state as the final reliable opportunity to preserve application state.
  • Use the pagehide event when code must respond to navigation away from a page while remaining compatible with the back/forward cache.
  • Update internal development standards, support documentation, and testing guidance.
  • Notify application owners, support teams, and affected users of any application-specific changes.

If an application cannot be updated before rollout completion, site owners can temporarily enable unload support through Permissions Policy. Administrators can also use the ForcePermissionPolicyUnloadDefaultEnabled Microsoft Edge policy to retain the previous default behavior while migration work is completed. These controls are intended to provide migration time and should not be considered permanent solutions. A website can still apply a more restrictive Permissions Policy configuration.

Learn more

[Compliance considerations]

No compliance considerations identified. Review as appropriate for your organization.

Machine Translation

もしあなたのウェブサイトやアプリケーションがアンロードイベントハンドラ(アンロード)を使用していなければ、以下に述べる影響は適用されず、何の対応も必要ありません。

[何となぜ]

Microsoft Edgeは、アンロードイベントハンドラの継続的な廃止の一環として、ウェブプラットフォームのアンロードイベントのデフォルトの挙動を変更しています。

現在、アンロードイベントハンドラはデフォルトで許可されています。この変更が導入されると、サイトが権限ポリシーで明示的に許可しない限り、ページはアンロードイベントハンドラを実行しなくなります。組織はアプリケーションオーナーと協力し、これらのシナリオ向けに設計された最新のライフサイクルイベントやAPIにアプリケーションを移行すべきです。

アンロードイベントは、ブラウザやオペレーティングシステムがページを起動せずに一時停止または終了できるため、データの保存やクリーンアップ操作、ユーザーセッション終了の確認には信頼性が高くありません。また、ページのバック/フォワードキャッシュの使用を妨げることもあり、ナビゲーション性能に影響を与える可能性があります。

[展開スケジュール]

  • 世界規模、GCC、GCCハイ、DoD:2026年9月初旬から始まり、2026年10月に完了 予定です

[組織への影響]

影響を受ける人物

組織は、ユーザーが依存する内部ウェブサイト、公開ウェブサイト、またはサードパーティのウェブアプリケーションがアンロードイベントハンドラを使用して必要な機能を提供する場合、影響を受ける可能性があります。

ユーザーが影響を受けるのは、ウェブサイトやアプリケーションがアンロードイベントハンドラに依存し、代替実装を提供していない場合のみです。

ホームとサービス

  • Microsoft Edge
  • Microsoft Edgeで開かれたウェブサイトやウェブアプリケーション
  • WebView2ベースのアプリケーション
  • マネージドされたMicrosoft Edge環境

何が起こるのか

アンロードイベントハンドラに依存するウェブサイトやアプリケーションは、ハンドラがデフォルトで動作しなくなった場合に機能的な変更が発生することがあります。

一般的なシナリオには、アンロードハンドラーを以下に使うアプリケーションが含まれます:

  • ユーザーデータの保存
  • リリースリソース
  • 分析データやテレメトリを送信してください
  • セッション終了を通知する

組織は、 ForcePermissionPolicyUnloadDefaultEnabledMicrosoft Edgeポリシーを有効にすることで、アプリケーションの更新中に現在の動作を一時的に維持できます。このポリシーは、アプリケーション所有者が影響を受けたアプリケーションを更新する間の移行支援としてのみ意図されています。ウェブサイトは依然としてより制限的な権限ポリシーの設定を適用できます。

[行動が必要と提言]

以下の手続きを2026年9月6日までに完了してください:

  • 外部およびビジネスクリティカルなウェブアプリケーションを特定し、サードパーティライブラリを通じて導入されたハンドラを含むアンロードイベントハンドラを登録します。
  • アンロードイベントハンドラに頼らずにアプリケーションの動作を検証できます。
  • Microsoft Edge DevToolsを使って、アンロードリスナーのせいでバック/フォワードキャッシュの使用がブロックされているページを特定しましょう。
  • データ節約シナリオを可視変更イベントに移行し、隠れた状態への遷移をアプリケーション状態を保存する最終的な確実な機会として活用します。
  • ページから離れるナビゲーションにコードが応答しつつ、バック/フォワードキャッシュとの互換性を保つ必要がある場合にpagehideイベントを使用します。
  • 社内開発標準、サポートドキュメント、テストガイダンスを更新しましょう。
  • アプリケーション固有の変更があれば、アプリケーションの所有者、サポートチーム、影響を受けるユーザーに通知してください。

ロールアウト完了前にアプリケーションを更新できない場合、サイト所有者は権限ポリシーを通じて一時的にアンロードサポートを有効にすることができます。管理者はまた、 ForcePermissionPolicyUnloadDefaultEnabledMicrosoft Edgeポリシーを使って、移行作業が完了する間も以前のデフォルト動作を保持できます。これらの制御は移行時間を確保するためのものであり、恒久的な解決策とは見なすべきではありません。ウェブサイトはより制限的な権限ポリシー設定を適用することも可能です。

詳しくはこちら

[コンプライアンスの考慮事項]

コンプライアンス上の考慮事項は特定されていません。組織に応じた適切なレビューを行ってください。