Заметки о выпуске для SDK WebView2

Следующие новые функции и исправления ошибок доступны в пакетах SDK для выпуска WebView2 и предварительных пакетов SDK.

Предварительная версия пакета SDK 1.0.4181 — предварительная версия для среды выполнения 152 (3 августа 2026 г.)

Дата выхода: 3 августа 2026 г.

Пакет NuGet для SDK WebView2 1.0.4181-prerelease

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, поставляемая с Microsoft Edge версии 152.0.4181.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

API диагностического монитора

API DiagnosticMonitor предоставляет поверхность ведения журнала только для наблюдения, которая позволяет основному приложению собирать подробные диагностические сигналы из WebView2. Монитор наблюдает сигналы от всех веб-представлений, профилей и среды через одно DiagnosticReceived событие.

Событие предназначено для автономного анализа или телеметрической пересылки; Его нельзя перехватить, изменить или отложить.

Ведущее приложение создает монитор, вызывая CoreWebView2Environment.CreateDiagnosticMonitor. Только что созданный монитор является инертным и не передает события, пока приложение не согласится на каждую категорию, вызвав SetDiagnosticFilter с помощью категории диагностики (например, NetworkRequest) и строки фильтра JSON.

Процесс "Передать "{}" " SetDiagnosticFilter получает все события в этой категории. Непустой объект JSON применяет сопоставление на уровне полей (например, для фильтрации сетевых запросов) к определенным errorCode значениям ИЛИ httpMethod .

При повторном вызове SetDiagnosticFilter той же категории заменяется предыдущий фильтр.

Каждое DiagnosticReceived событие предоставляет Category, Scope, Timestamp, и DetailsAsJson полезные данные, схема которых определена для каждой категории с набором гарантированных полей. API по умолчанию имеет тип JSON-in/JSON-out, поэтому новые категории и поля могут поставляться без нарушения контракта API; Потребители должны игнорировать неизвестные ключи.

Отпускание или закрытие монитора останавливает все события и очищает все фильтры.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлены невидимые глифы кнопки подписи на темных фонах элементов управления окном.
  • Ограничение доступа к каналу узла singleton в устаревших клиентах WebView2.
  • Удалено неявное window.gc добавление в веб-представлениях.
  • Исправлено объявление "скачать ярлык" средствами чтения с экрана.
  • Исправлена проблема мерцания Min/Max/Close в наложении элементов управления Windows.
  • Исправлено соблюдение пользовательского коэффициента масштабирования для печати PDF.
  • Исправлена логика привязки для всплывающего окна скачивания в минимальном окне.
  • Исправлена невозможность перетащить окно через верхнюю границу пользовательского заголовка окна.
Только пакет SDK
  • Исправлен сбой WPF при изменении топологии отображения в приложениях, управляемых композицией.

Выпуск SDK 1.0.4129.50 для среды выполнения 151 (3 августа 2026 г.)

Дата выхода: 3 августа 2026 г.

Пакет NuGet для SDK WebView2 1.0.4129.50

Для полной совместимости с API для этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 151.0.4129.50 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Ограничение доступа к каналу узла singleton в устаревших клиентах WebView2.

Предварительная версия пакета SDK 1.0.4126 — предварительная версия для среды выполнения 151 (7 июля 2026 г.)

Дата выхода: 7 июля 2026 г.

Пакет NuGet для SDK WebView2 1.0.4126 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 151.0.4126.0 или более поздней.

Общие изменения

Среда выполнения WebView2 изменяется на 2-недельный цикл выпуска

Начиная с версии 152 (24 августа 2026 г.) среда выполнения WebView2 переходит к 2-недельному циклу выпуска. Это соответствует Microsoft Edge. Среда выполнения WebView2 версии 151 — это последний выпуск, который выпускается каждые 4 недели.

Смотрите [Объявление] Среда выполнения WebView2 переходит к 2-недельной периодичности выпуска (начиная с версии 152).

Запускайте свое хост-приложение WebView2 со статусом обычного пользователя, а не с повышенными привилегиями

Запускайте свое хост-приложение WebView2 со статусом обычного пользователя, а не с повышенными правами. Рекомендуемый уровень привилегий для приложений узла WebView2 см. в статье "Разработка безопасных приложений WebView2".

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Отчет о сбоях в ProcessFailed событии

API CrashReport предоставляет диагностические данные о сбоях, когда процесс WebView2 завершается сбоем со сбоем. При возникновении ProcessFailed события ведущее приложение может получить доступ к свойству CrashReport в Excel ProcessFailedEventArgs , чтобы получить сведения о сигнатуре сбоя, в том числе:

  • Код исключения.
  • Имя и версия сбойного модуля.
  • Смещение ошибки.
  • Идентификатор отчета о сбоях.
  • Идентификатор сегмента.
  • Время, когда было сообщено о крушении.

ProcessFailedEventArgs.CrashReport — это null когда сбой не привел к созданию отчета о сбое, например, в следующих сценариях:

  • Обычный выход.
  • Внешнее убийство процесса.
  • Сбой запуска.
  • Зависание.

ProcessFailedEventArgs.CrashReport также может возникать null для определенных сбоев аварийного типа, когда отчет не был создан. Приложения узла всегда должны проверка перед null доступом к свойствам.

Настройка параметров проверки репутации для каждого источника (SmartScreen)

Эта ReputationChecking функция позволяет приложению WebView2 пропускать проверки репутации фильтра SmartScreen при переходах и загрузках из определенных надежных источников. ReputationChecking является членом перечисления CoreWebView2OriginFeature .

Если эта функция настроена на CoreWebView2OriginFeatureState.Disabled источник, проверки репутации фишинга и вредоносных программ обходятся для этого источника. Если эта функция не настроена для источника, CoreWebView2Settings.IsReputationCheckingRequired применяется глобальная настройка; предпочтение на уровне процесса браузера применяется для всех процессов, использующих ее.

Если CoreWebView2Settings.IsReputationCheckingRequired задано значение false, настройка CoreWebView2OriginFeatureState.Enabled для источника не включает повторные проверки репутации для этого источника; CoreWebView2Settings.IsReputationCheckingRequired имеет приоритет.

Старые поддерживающие API:

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлен повторный вход для удаления фрейма.
  • Исправлен доступ к оболочке объекта для файла авторизации пользователя (UAF).
  • Автор браузера отметен в канале размещения во избежание спуфинга WebMessageReceivedEventArgs.Source .
  • Ограничен доступ к каналу узла singleton в устаревшем WebView2.
  • Удален origin параметр из методов, которые обращаются к собственному объекту.
  • Усиленное принудительное применение виртуального узла kDeny WebView2 для защиты от спуфинга рендерера и escape-переходов NTFS-соединения.
  • Исправлено дерево модели автоматизации пользовательского интерфейса (UIA), связанное с визуальным оформлением окна.
  • Исправлена регрессия в AddScriptToExecuteOnDocumentCreated API.
  • Реализовано OnRendererResponsive для отслеживания результатов зависания.

Выпуск SDK 1.0.4078.44 для среды выполнения 150 (7 июля 2026 г.)

Дата выхода: 7 июля 2026 г.

Пакет NuGet для SDK WebView2 1.0.4078.44

Для полной совместимости с API для этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 150.0.4078.44 или более поздней.

Общие изменения

Среда выполнения WebView2 изменяется на 2-недельный цикл выпуска

См. статью Среда выполнения WebView2 изменяется на 2-недельный цикл выпуска в разделе "Предварительная версия" выше.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Исправлен повторный вход для удаления фрейма.
  • Исправлен доступ к оболочке объекта для файла авторизации пользователя (UAF).
  • Автор браузера отметен в канале размещения во избежание спуфинга WebMessageReceivedEventArgs.Source .
  • Ограничен доступ к каналу узла singleton в устаревшем WebView2.
  • Удален origin параметр из методов, которые обращаются к собственному объекту.
  • Усиленное принудительное применение виртуального узла kDeny WebView2 для защиты от спуфинга рендерера и escape-переходов NTFS-соединения.
  • Исправлено дерево модели автоматизации пользовательского интерфейса (UIA), связанное с визуальным оформлением окна.
  • Исправлена регрессия в AddScriptToExecuteOnDocumentCreated API.

Предварительная версия пакета SDK 1.0.4071 — предварительная версия для среды выполнения 150 (11 июня 2026 г.)

Дата выхода: 11 июня 2026 г.

Пакет NuGet для SDK WebView2 1.0.4071 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 150.0.4071.0 или более поздней.

Критические изменения

Включить поддержку рукописного ввода оболочки Windows для WebView2 в режиме WindowToVisual

WebView2 представляет поддержку рукописного ввода оболочки Windows (преобразование рукописного ввода пера в текст) для полей редактирования внутри экземпляров WebView2, размещенных в режиме Window to Visual (WindowToVisual) в Windows.

Это изменение затрагивает только WindowToVisual режим размещения. WindowToWindow режим размещения уже поддерживает рукописный ввод оболочки Windows, а VisualToVisual режим размещения не поддерживается этим изменением.

До этого изменения: WebView2 в WindowToVisual режиме не регистрирует в ITfHandwritingSink потоке Text Services Framework (TSF). Функция рукописного ввода оболочки Windows по-прежнему работает, но для определения цели рукописного ввода используется путь на основе модели автоматизации пользовательского интерфейса ОС (UIA).

После этого изменения: Если msAbydosForWindowlessWV2 флаг функции отключен, поведение остается таким же, как и до этого изменения, включая путь определения цели рукописного ввода на основе UIA.

msAbydosForWindowlessWV2 Если флаг функции включен, WebView2 в WindowToVisual режиме регистрирует каждый экземпляр ITfHandwritingSink в потоке TSF. Это включает рукописный ввод оболочки Windows для полей редактирования внутри WebView2 и изменяет способ маршрутизации событий рукописного ввода TSF в общем потоке TSF.

Если приложение уже зарегистрировано в ITfHandwritingSink потоке TSF, рукописный ввод пером будет по-прежнему работать в собственных полях редактирования приложения, а рукописный ввод пером также будет работать в полях редактирования WebView2.

Если приложение не регистрирует собственное ITfHandwritingSinkприложение, рукописный ввод может перестать работать с собственными полями редактирования приложения после включения этого изменения по умолчанию. Это происходит потому, что WebView2 возвращает E_NOTIMPL HWND, которые ему не принадлежат, ожидая, что TSF будет подключен к другому зарегистрированному приемнику. Если приемник узла не зарегистрирован, TSF не возвращается к целевому целевому разрешению рукописного ввода на основе UIA по умолчанию.

Чтобы сохранить поддержку рукописного ввода пером для собственных полей редактирования приложения, зарегистрируйте свое собственное ITfHandwritingSink в потоке TSF. Это изменение автоматически включает рукописный ввод пером в полях редактирования WebView2.

Вы можете заранее проверить поведение приложения WebView2, включив следующий флаг функции перед запуском приложения:

set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msAbydosForWindowlessWV2

В выпусках 149 и 150 msAbydosForWindowlessWV2 флаг функции по умолчанию отключен, что дает приложениям время для профилактического тестирования. Начиная с выпуска 151, эту функцию планируется включить по умолчанию.

Протестировав приложение WebView2 с включенным флагом функции, вы можете определить, зависят ли какие-либо рабочие процессы рукописного ввода с полями редактирования в вашем приложении от регистрации узла ITfHandwritingSink.

См. также:

Общие изменения

Вывод из употребления пакета NuGet DevToolsProtocolExtension

Пакет NuGet для DevToolsProtocolExtension 1.0.2901

Пакет Microsoft.Web.WebView2.DevToolsProtocolExtension NuGet является нерекомендуемым, и дальнейшие версии этого пакета публиковаться не будут. Это упразднение не связано с какими-либо пакетами SDK для выпуска WebView2 или предварительными пакетами SDK.

Пакет DevToolsProtocolExtension предоставляет строго типизированную оболочку .NET поверх протокола Chrome DevTools Protocol (CDP) для использования в приложениях WebView2. Существующие опубликованные версии (1.0.824, 1.0.2271и 1.0.2901) остаются доступными в коллекции NuGet и не удаляются.

См. также:

Рекомендуемая альтернатива:

Все вызовы CDP можно выполнять непосредственно через API CDP WebView2, без использования пакета расширения. См. статью Использование протокола Chrome DevTools Protocol (CDP) в приложениях WebView2 и следующее:

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

В этот предварительный выпуск SDK не добавлены экспериментальные API.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Среда выполнения и пакет SDK
  • Добавлены гистограммы общего количества для среды WebView2 и попыток создания контроллера.
Только среда выполнения
  • Сопоставлено TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICY с kLaunchFailed.
  • Обновлена классификация причины сбоя на OOM, для процесса, который был завершен для освобождения памяти.
  • Добавлен snapshot системной памяти во время обнаружения нехватки памяти (OOM) для анализа.
  • Исправлено тихое закрытие всплывающего окна, когда средство обработки ожидает, что всплывающее окно останется открытым.
  • Добавлена проверка доверенного источника при доступе к объекту узла.
  • Сокращено количество избыточных поисков на карте в диспетчере URL-адресов WebView2 для повышения производительности.
  • Устранено ненужное выделение строк в слое файлов cookie WebView2 для повышения производительности.
Только пакет SDK
  • Исправлены проблемы безопасности контейнера во фрейме WebView2 и коде прослушивателя.
  • Подписка на событие WinRT теперь поддерживает работу оболочки проекции до тех пор, пока обработчик не отменит подписку.

Выпуск SDK 1.0.4022.49 для среды выполнения 149 (11 июня 2026 г.)

Дата выхода: 11 июня 2026 г.

Пакет NuGet для SDK WebView2 1.0.4022.49

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 149.0.4022.49 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Перечисленные ниже интерфейсы API были переведены из фазы 2 (стабильная в предварительной версии) в фазу 3: стабильная в выпуске и теперь включены в этот пакет SDK.

Включить фоновую обработку и автономную поддержку (API рабочих сценариев WebView2)

API рабочих сценариев WebView2 позволяют ведущим приложениям взаимодействовать с рабочими веб-процессами для разгрузки задач из основного потока, повышения скорости отклика и поддержки фоновых операций. К этим рабочим веб-процессам относятся выделенные сотрудники, общие рабочие процессы и служебные сценарии.

Эти API предоставляют следующие возможности:

  • События жизненного цикла: Следить за созданием и уничтожением рабочих.
  • Интерфейсы обмена сообщениями: Общайтесь с работниками с помощью и PostMessageWebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление работниками: Запрашивать и извлекать регистрации и экземпляры рабочих ролей.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Сопоставлено TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICY с kLaunchFailed.
  • Обновлена классификация причины сбоя на OOM, для процесса, который был завершен для освобождения памяти.
  • Добавлена проверка доверенного источника при доступе к объекту узла.
  • Исправлена ошибка, из-за которой раскрывающиеся списки диалогового окна печати не выбирались в WebView2CompositionControl. (Выпуск #5195)
Только пакет SDK
  • Исправлены проблемы безопасности контейнера во фрейме WebView2 и коде прослушивателя.

Предварительная версия пакета SDK 1.0.4015 — предварительная версия для среды выполнения 149 (11 мая 2026 г.)

Дата выпуска: 11 мая 2026 г.

Пакет NuGet для SDK WebView2 1.0.4015 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 149.0.4015.0 или более поздней.

Критические изменения

EnhancedSecurityModeLevel Заменено на EnhancedSecurityModeState

Свойство CoreWebView2Profile.EnhancedSecurityModeLevel и CoreWebView2EnhancedSecurityModeLevel перечисление являются нерекомендуемыми и будут удалены в следующем выпуске. Замените любое использование этих API в приложении WebView2 следующим образом.

Старое свойство CoreWebView2Profile.EnhancedSecurityModeLevelуправляло включением или отключением режима усиленной безопасности (ESM) для всех экземпляров WebView2, связанных с профилем. Это свойство переименовано в EnhancedSecurityModeState, чтобы более четко сообщать о состоянии режима усиленной безопасности.

До этого изменения: Свойство CoreWebView2Profile.EnhancedSecurityModeLevel использовало перечисление со значениями CoreWebView2EnhancedSecurityModeLevelOff и Strict.

После этого изменения: Свойство CoreWebView2Profile.EnhancedSecurityModeState использует перечисление CoreWebView2EnhancedSecurityModeState со значениями Disabled и Enabled:

  • CoreWebView2EnhancedSecurityModeState.Disabled — Режим повышенной безопасности отключен.

    • Заменяет CoreWebView2EnhancedSecurityModeLevel.Off.

  • CoreWebView2EnhancedSecurityModeState.Enabled — Режим повышенной безопасности включен.

    • Отключает компиляцию JavaScript "Точно в срок" (JIT).
    • Включает дополнительные средства защиты операционной системы.
    • Заменяет CoreWebView2EnhancedSecurityModeLevel.Strict.

См. также:

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Состояние режима усиленной безопасности

Свойство EnhancedSecurityModeStateCoreWebView2Profile определяет, включен ли режим усиленной безопасности (ESM) для всех экземпляров WebView2, связанных с профилем.

При включении режима усиленной безопасности отключается компиляция JavaScript "на лету" (JIT) и включаются дополнительные средства защиты операционной системы, сокращающие поверхность атак за счет некоторой производительности JavaScript.

Значение по умолчанию — Disabled. Изменения применяются немедленно к новым переходам; Существующие страницы требуют перезагрузки.

Этот параметр не сохраняется и сбрасывается при уничтожении и повторном создании профиля.

Акции до фазы 2 (стабильная в предварительной версии)

Следующие API были переведены с фазы 1: экспериментальная в предварительной версии до фазы 2: стабильная в предварительной версии, и включены в этот предварительный пакет SDK.

Включить фоновую обработку и автономную поддержку (API рабочих сценариев WebView2)

API рабочих сценариев WebView2 позволяют ведущим приложениям взаимодействовать с рабочими веб-процессами для разгрузки задач из основного потока, повышения скорости отклика и поддержки фоновых операций. К этим рабочим веб-процессам относятся выделенные сотрудники, общие рабочие процессы и служебные сценарии.

Эти API предоставляют следующие возможности:

  • События жизненного цикла: Следить за созданием и уничтожением рабочих.
  • Интерфейсы обмена сообщениями: Общайтесь с работниками с помощью и PostMessageWebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление работниками: Запрашивать и извлекать регистрации и экземпляры рабочих ролей.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлен двойной символ в UWP.
  • Caption controls исправлен API настройки цвета фона. После этого изменения, чтобы закрыть приложение, приложению также потребуется перехватить Close вызов и обработать его самостоятельно.
  • Исправлена пересылка сетевых событий для iframe, где у iframe был свой изолированный сеанс CDP.
  • Улучшена обработка ошибок при вызове Post Message (например, CoreWebView2ServiceWorker.PostWebMessageAsJson или chrome.webview.postMessage) в служебном сценарии.
  • Сокращенное выделение строк в GetDefaultHostAppExeName.
  • Исправлена проблема средства обновления, из-за которой используемая в настоящее время среда выполнения WebView2 удалялась после установки новой версии, что вызывало сбой при создании нового контроллера в уже запущенном приложении.

Release SDK 1.0.3967.48, для среды выполнения 148 (11 мая 2026 г.)

Дата выпуска: 11 мая 2026 г.

Пакет NuGet для SDK WebView2 1.0.3967.48

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 148.0.3967.48 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена проблема средства обновления, из-за которой используемая в настоящее время среда выполнения WebView2 удалялась после установки новой версии, что вызывало сбой при создании нового контроллера в уже запущенном приложении.

Предварительная версия пакета SDK 1.0.3965 — предварительная версия для среды выполнения 148 (13 апреля 2026 г.)

Дата выхода: 13 апреля 2026 г.

Пакет NuGet для SDK WebView2 1.0.3965 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 148.0.3965.0 или более поздней.

Критические изменения

Подробные причины сбоя процесса для ProcessFailed события

Событие ProcessFailed запускается при неожиданном завершении процесса, связанного с WebView2 (например, процесса отрисовки или графического процессора), позволяя приложениям реагировать с помощью логики восстановления или диагностики.

До этого изменения: Свойство CoreWebView2ProcessFailedEventArgs.Reason , возвращаемое Unexpected для трех различных сценариев выхода (обычный выход, аномальный выход и сбой целостности кода), из-за чего приложения не могут различать их.

После этого изменения: Когда msWebView2GranularProcessFailedReason флаг функции включен, свойство CoreWebView2ProcessFailedEventArgs.Reason возвращает вместо CoreWebView2ProcessFailedReasonUnexpected:

  • NormalExit — Процесс завершился нормально (код выхода 0).

  • AbnormalExit — Процесс завершился ненормально (ненулевой код выхода), но не упал и не погиб.

  • IntegrityFailure — ОС прекратила процесс из-за сбоя целостности кода, например, когда DLL не проходит проверку целостности кода Windows.

Флаг msWebView2GranularProcessFailedReason функции по умолчанию отключен в выпусках 148 и 149, предоставляя приложениям два выпуска для упреждающего тестирования. Начиная с выпуска 150, эта функция будет включена по умолчанию, а приложения будут получать детализированные значения. Чтобы проверить поведение приложения WebView2, включите флаг функции, как показано ниже.

set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msWebView2GranularProcessFailedReason

Это исправление ошибки для среды выполнения и пакета SDK. Эти члены перечисления являются модификацией существующего стабильного API и доступны как часть этого предварительного выпуска SDK.

См. также:

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

API конфигурации источника для WebView2

API конфигурации источника позволяет приложениям WebView2 применять различные функции и политики безопасности в зависимости от источника размещенного контента. По умолчанию WebView2 применяет единую политику во всех источниках. Этот API позволяет приложениям выборочно включать или отключать определенные функции (например, режим повышенной безопасности) для отдельных источников или шаблонов источников.

Используйте этот методCoreWebView2Profile, SetOriginFeatures чтобы настроить параметры функции для одного или нескольких источников. Происхождения могут быть указаны в виде точных строк (например, https://contoso.com) или шаблонов подстановочных знаков (например, https://[*.]contoso.com) для сопоставления поддоменов, протоколов или портов.

Когда несколько конфигураций применяются к одному источнику, наиболее конкретный шаблон имеет приоритет, оцениваемый по имени хоста, затем схеме, а затем порту.

Используется GetEffectiveFeaturesForOrigin для асинхронного получения параметров вычисляемых функций для данного источника.

Этап 2 (стабильная в предварительной версии)

Следующие члены перечисления представляют собой модификацию существующего стабильного API и доступны в составе этого предварительного выпуска пакета SDK.

Подробные причины сбоя процесса для ProcessFailed события

Дополнили CoreWebView2ProcessFailedReason.Unexpected член перечисления, добавив более подробные значения для CoreWebView2ProcessFailedReason перечисления, возвращаемого свойством CoreWebView2ProcessFailedEventArgs.Reason .

Это переломное изменение; Подробные причины сбоя процесса для ProcessFailed события см. выше.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Среда выполнения и пакет SDK
  • Дополнили CoreWebView2ProcessFailedReason.Unexpected член перечисления, добавив более подробные значения для CoreWebView2ProcessFailedReason перечисления, возвращаемого свойством CoreWebView2ProcessFailedEventArgs.Reason . Это критическое изменение. Подробные причины сбоя процесса для ProcessFailed события см. выше.
Только среда выполнения

  • Исправлены проблемы с выбором раскрывающегося списка диалогового окна печати в WebView2CompositionControl. (Выпуск #5195)

  • Отключен компонент "Действия домена" для WebView2.

  • Отключено WebUSBDetector уведомление для WebView2.

  • Исправлено устаревшее ICoreWebView2Profile3::get_PreferredTrackingPreventionLevel.

  • Исправлена ошибка, из-за которой клиентам WDP не удавалось подключиться к удаленному серверу отладки.

  • Исправлена проблема с примером приложения WPF, из-за которой при закрытии окна оставался затянувшийся процесс WPF.

Только пакет SDK
  • Включено ведение журнала гистограммы для сбоев процесса браузера в WebView2.

Выпуск SDK 1.0.3912.50 для среды выполнения 147 (13 апреля 2026 г.)

Дата выхода: 13 апреля 2026 г.

Пакет NuGet для SDK WebView2 1.0.3912.50

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 147.0.3912.50 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения

  • Отключен компонент "Действия домена" для WebView2.

  • Исправлена ошибка, из-за которой клиентам WDP не удавалось подключиться к удаленному серверу отладки.

Предварительная версия пакета SDK 1.0.3908 — предварительная версия для среды выполнения 147 (16 марта 2026 г.)

Дата выхода: 16 марта 2026 г.

Пакет NuGet для SDK WebView2 1.0.3908 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 147.0.3908.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

В этот предварительный выпуск SDK не добавлены экспериментальные API.

Акции до фазы 2 (стабильная в предварительной версии)

Следующие API пропустили фазу 1: экспериментальную в предварительной версии и были непосредственно добавлены в фазу 2: стабильную в предварительной версии, а также включены в эту предварительную версию пакета SDK.

Управление разрешениями постоянного хранилища для веб-контента

Это PersistentStorage разрешение позволяет приложению WebView2 обрабатывать запросы от веб-содержимого на сохранение данных, создаваемых API хранилища, служебными сценариями и связанными технологиями. Разрешение PersistentStorage является членом перечисления в CoreWebView2PermissionKind перечислении.

Если такое разрешение предоставлено, браузер не вытесняет сохраненные данные в сценариях нехватки места на диске. Это обеспечивает надежное поведение сайта в автономном режиме и в режиме кэширования.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена ошибка, из-за которой при отключении экрана неправильно менялось разрешение экрана.
  • Фиксированное разрешение на каждый монитор в window.getScreenDetails(). (Выпуск #4826)
  • Отключен компонент действий домена для WebView2.
  • Исправлен сбой API печати в PDF при печати PDF-файлов. (Выпуск #5499)
  • Исправлена проблема, из-за которой экранный диктор объявлял структуру HWND, у которой нет пользовательского интерфейса.
  • Исправлена прозрачность WebView2.
  • Исправлен API для настройки цвета фона элемента управления "Субтитры ".

Выпуск SDK 1.0.3856.49 для среды выполнения 146 (16 марта 2026 г.)

Дата выхода: 16 марта 2026 г.

Пакет NuGet для SDK WebView2 1.0.3856.49

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 146.0.3856.49 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Исправлен сбой API печати в PDF при печати PDF-файлов. (Выпуск #5499)

Предварительная версия пакета SDK 1.0.3848-предварительная версия для среды выполнения 146 (16 февраля 2026 г.)

Дата выхода: 16 февраля 2026 г.

Пакет NuGet для SDK WebView2 1.0.3848 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 146.0.3848.0 или более поздней.

Критические изменения

Включить API-интерфейсы Javascript, специфичные для WebView2, для служебных сценариев

Новый AreWebViewScriptApisEnabledForServiceWorkers параметр предоставляет явный и надежный способ управления доступностью API-интерфейсов JavaScript (chrome.webview) для WebView2 в сценариях служебных сценариев.

Этот параметр по умолчанию отключен для приложений WebView2. Приложения, которые явно не включают этот параметр, не будут иметь доступа к API JavaScript WebView2 в сценариях служебных сценариев. В результате взаимодействие на основе chrome.webview.postMessage служебных сценариев с ведущим приложением WebView2 не будет работать, если этот параметр не включен.

В дальнейшем WebView2 будет полагаться на этот AreWebViewScriptApisEnabledForServiceWorkers параметр в качестве авторитетного механизма для включения API-интерфейсов JavaScript, специфичных для WebView2, в сценариях служебных сценариев. Это обеспечивает предсказуемое, безопасное и детерминированное поведение.

Вы можете упреждающе проверить поведение приложения WebView2, включив интерфейс API JavaScript служебного сценария в приложении WebView2. Для этого настройте приложение, включив следующий параметр:

AreWebViewScriptApisEnabledForServiceWorkers = true

Протестировав приложение WebView2 с включенным параметром, вы можете определить все рабочие процессы, зависящие от API-интерфейсов сервис-сценариев, специфичных для WebView2, такие как chrome.webview.postMessage взаимодействие между служебными сценариями и ведущим приложением.

В chrome настоящее время объекты and chrome.webview доступны сценариям служебных сценариев при использовании ServiceWorkerRegistered события. Однако начиная со следующего выпуска этот параметр будет единственным механизмом, определяющим, AreWebViewScriptApisEnabledForServiceWorkers предоставляются ли эти объекты сценариям служебного сценария. Проверьте этот параметр перед следующим выпуском и сообщите о любых проблемах, с которыми вы столкнетесь. Подробные сведения см. в статье [Критическое изменение] Включение API-интерфейсов JavaScript для WebView2 для служебных сценариев.

См. также Управление включением API скриптов WebView для служебных сценариев ниже.

Доступ к локальной сети (LNA) в WebView2

В движке браузера Chromium появился доступ к локальной сети (LNA). LNA — это функция безопасности, которая не позволяет веб-страницам делать запросы к частным или локальным сетевым ресурсам, если у веб-страницы нет явного разрешения на доступ к частным или локальным сетевым ресурсам. Примерами таких ресурсов являются localhost, 192.168.*или 10.*.

В настоящее время LNA отключен по умолчанию для приложений WebView2, но вы можете включить поддержку LNA с помощью флага msWebViewAllowLocalNetworkAccessChecks . Для приложений WebView2 в настоящее время не требуется никаких действий. Сведения о флаге см. в разделе Доступные флаги браузера WebView2 в флагах браузера WebView2.

После того, как вышестоящая кодовая база Chromium стабилизируется, мы планируем добавить дополнительные значения перечисления в CoreWebView2PermissionKind перечисление для поддержки LNA через SetPermissionState метод. Эти новые значения перечисления будут использоваться событием UWP WebView.PermissionRequested , чтобы предоставить приложению WebView2 явный контроль над функцией доступа к локальной сети (LNA).

Вы можете заранее протестировать функцию доступа к локальной сети (LNA) в своем приложении WebView2. Чтобы протестировать приложение с функцией LNA, запустите приложение WebView2 со следующим флагом:

--enable-features=LocalNetworkAccessChecks,msWebViewAllowLocalNetworkAccessChecks

Протестировав приложение при запуске с этим флагом, можно определить рабочие процессы, на которые может повлиять функция LNA.

После стабилизации функции LNA мы опубликуем обновленную временную шкалу включения функции LNA. Подробные сведения см. в статье [Критическое изменение] Доступ к локальной сети (LNA) в WebView2 — план развертывания.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Управление включением API скриптов WebView для служебных сценариев

Используйте свойство onCoreWebView2Profile, AreWebViewScriptApisEnabledForServiceWorkers чтобы управлять включением API сценариев WebView для служебных сценариев.

См. также раздел Включение API-интерфейсов Javascript для WebView2 для служебных сценариев выше.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения

  • Исправлена ошибка, из-за которой исчезала панель инструментов PDF, когда удалялись все параметры в регионе. (Выпуск #4738)

  • Исправлена белая вспышка, возникавшая, когда Windows Search становился видимым после скрытия.

  • Исправлена тень заголовка окна, чтобы она не отображалась в прозрачном элементе управления WebView2. (Выпуск #5492)

  • Исправлена прозрачность WebView2.

  • Исправлена проблема с запросами при доступе к локальной сети (LNA) путем отключения проверок LNA в WebView2.

Выпуск SDK 1.0.3800.47 для среды выполнения 145 (16 февраля 2026 г.)

Дата выхода: 16 февраля 2026 г.

Пакет NuGet для SDK WebView2 1.0.3800.47

Для полной совместимости с API для этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 145.0.3800.47 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения

  • Исправлена тень заголовка окна, чтобы она не отображалась в прозрачном элементе управления WebView2. (Выпуск #5492)

  • Исправлена проблема с запросами при доступе к локальной сети (LNA) путем отключения проверок LNA в WebView2.

  • Исправлена прозрачность WebView2.

Предварительная версия пакета SDK 1.0.3796 — предварительная версия для среды выполнения 145 (19 января 2026 г.)

Дата выхода: 19 января 2026 г.

Пакет NuGet для SDK WebView2 1.0.3796 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 145.0.3796.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Уровень режима повышенной безопасности

API режима усиленной безопасности позволяет настраивать режим усиленной безопасности (ESM) для экземпляров WebView2. ESM снижает риск возникновения уязвимостей, связанных с памятью, за счет отключения JIT-компиляции JavaScript и включения дополнительных средств защиты операционной системы.

Чтобы управлять уровнем ESM для всех экземпляров WebView2, которые используют один и тот же профиль, используйте свойство EnhancedSecurityModeLevel на CoreWebView2Profile (или ICoreWebView2ExperimentalProfile9):

  • Используйте это Off значение для полного отключения режима усиленной безопасности (поведение по умолчанию).

  • Используйте это Strict значение для включения усиленной безопасности для всех сайтов. Это отключает JIT-компиляцию и применяет дополнительные средства защиты на уровне ОС, повышая безопасность, но потенциально снижая производительность JavaScript.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена chrome.webview недоступность.
  • Отключено фоновое обновление сетевого времени.
Только пакет SDK

Выпуск SDK 1.0.3719.77 для среды выполнения 144 (27 января 2026 г.)

Дата выхода: 27 января 2026 г.

Пакет NuGet для SDK WebView2 1.0.3719.77

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 144.0.3719.77 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Перечисленные ниже интерфейсы API были переведены из фазы 2 (стабильная в предварительной версии) в фазу 3: стабильная в выпуске и теперь включены в этот пакет SDK.

Настройка поведения перетаскивания (API DragStarting)

API DragStarting переопределяет поведение перетаскивания по умолчанию при работе в режиме визуального размещения. Это DragStarting событие уведомляет ваше приложение, когда пользователь запускает операцию перетаскивания в WebView2, и предоставляет состояние, необходимое для переопределения операции перетаскивания WebView2 по умолчанию с помощью собственной логики.

  • Используйте DragStarting для ICoreWebView2CompositionController5 добавления обработчика событий, который вызывается при запуске операции перетаскивания.
  • Используется ICoreWebView2DragStartingEventArgs для запуска собственной операции перетаскивания.
    • Используйте этот GetDeferral метод для выполнения любой логики асинхронного перетаскивания и вызова в веб-представление позже.
    • Используйте свойство Handled , чтобы сообщить WebView2, следует ли использовать собственную логику перетаскивания.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена chrome.webview недоступность.
Только пакет SDK

Предварительная версия пакета SDK 1.0.3712 — предварительная версия для среды выполнения 144 (8 декабря 2025 г.)

Дата выхода: 8 декабря 2025 г.

Пакет NuGet для SDK WebView2 1.0.3712 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 144.0.3712.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Настройка поведения диапазона портов

API разрешенного диапазона портов позволяют ограничить или настроить диапазоны сетевых портов, которые WebView2 может использовать для различных транспортных протоколов и областей. Это обеспечивает расширенный контроль безопасности.

  • Используйте SetAllowedPortRange экземпляр ( CoreWebView2EnvironmentOptions или ICoreWebView2ExperimentalEnvironmentOptions) для настройки ограничений портов во время создания среды.

    • Используйте этот параметр, scope чтобы указать, применяется ли конфигурация ко всем компонентам (Default) или только к одноранговым соединениям WebRTC (WebRtc). Поддерживается только WebRtc в настоящее время.

    • Используйте protocol этот параметр для указания транспортного протокола (в настоящее время поддерживается Udp).

    • Укажите minPortmaxPort и значения в диапазоне 1025-65535 (включительно) или используйте (0,0) для сброса или снятия ограничений.

  • Используйте GetEffectiveAllowedPortRange экземпляр (CoreWebView2EnvironmentOptionsили ICoreWebView2ExperimentalEnvironmentOptions) для получения конфигурации активного диапазона портов для определенной области и протокола.

    • Возвращает явно заданный диапазон для данной области или наследует от Default области, если не задан.

    • Возвращает значение (0,0), если для указанной области не настроены ограничения.

Акции до фазы 2 (стабильная в предварительной версии)

Следующие API были переведены с фазы 1: экспериментальная в предварительной версии до фазы 2: стабильная в предварительной версии, и включены в этот предварительный пакет SDK.

Настройка поведения перетаскивания (API DragStarting)

API DragStarting переопределяет поведение перетаскивания по умолчанию при работе в режиме визуального размещения. Это DragStarting событие уведомляет ваше приложение, когда пользователь запускает операцию перетаскивания в WebView2, и предоставляет состояние, необходимое для переопределения операции перетаскивания WebView2 по умолчанию с помощью собственной логики.

  • Используйте DragStarting для ICoreWebView2CompositionController5 добавления обработчика событий, который вызывается при запуске операции перетаскивания.
  • Используется ICoreWebView2DragStartingEventArgs для запуска собственной операции перетаскивания.
    • Используйте этот GetDeferral метод для выполнения любой логики асинхронного перетаскивания и вызова в веб-представление позже.
    • Используйте свойство Handled , чтобы сообщить WebView2, следует ли использовать собственную логику перетаскивания.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена ошибка, из-за которой при доступе к локальной сети запускалось всплывающее окно оповещения о разрешениях.
  • Исправлена регрессия setColorScheme API.
  • Исправлена отложенная инициализация ICoreWebView2NewWindowRequestedEventArgs для параметра enable-new-window-requested-deferred-initializationкомандной строки.

Выпуск SDK 1.0.3650.58 для среды выполнения 143 (8 декабря 2025 г.)

Дата выхода: 8 декабря 2025 г.

Пакет NuGet для SDK WebView2 1.0.3650.58

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 143.0.3650.58 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Только среда выполнения
  • Исправлена ошибка, из-за которой при доступе к локальной сети запускалось всплывающее окно оповещения о разрешениях.

Предварительная версия пакета SDK 1.0.3650 — предварительная версия для среды выполнения 143 (7 ноября 2025 г.)

Дата выхода: 7 ноября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3650 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 143.0.3650.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

В этот предварительный выпуск SDK не добавлены экспериментальные API.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Отключено создание процесса "Спекулятивный рендерер".
  • Исправлена проблема синхронизации диалогового окна поиска при программном выполнении поиска.

Выпуск SDK 1.0.3595.46 для среды выполнения 142 (3 ноября 2025 г.)

Дата выхода: 3 ноября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3595.46

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 142.0.3595.46 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Отключено создание процесса "Спекулятивный рендерер".

Предварительная версия пакета SDK 1.0.3590 — предварительная версия для среды выполнения 142 (7 октября 2025 г.)

Дата выхода: 7 октября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3590 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, поставляемая с Microsoft Edge версии 142.0.3590.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

Следующие API находятся в фазе 1: Экспериментальные в предварительной версии и были добавлены в этот предварительный выпуск SDK.

Поддержка меток конфиденциальности

Новый API сведений о конфиденциальности в WebView2 позволяет приложениям получать доступ к сведениям меток конфиденциальности, передаваемым веб-страницами через диспетчер ограничений взаимодействия со страницами. Эта функция помогает приложениям размещения обнаруживать конфиденциальное содержимое и реагировать на него.

Основные возможности:

  • Настройка доступности диспетчера ограничения взаимодействия со страницей — настройка списка фильтров URL-адресов для диспетчера ограничений взаимодействия со страницей. После настройки списка диспетчер ограничения взаимодействия со страницей становится доступным на страницах списка разрешений. Эти страницы могут отправлять метки конфиденциальности платформе через API.

  • Воздействие - CoreWebView2сведений о конфиденциальности Теперь предоставляет свойство SensitivityInfo и SensitivityInfoChanged событие, позволяя приложениям прослушивать обновления сведений меток конфиденциальности.

Поддержка меток конфиденциальности изначально доступна только в Win32. Поддержка .NET и WinRT планируется в будущем выпуске.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только среда выполнения
  • Исправлен висящий указатель в контексте разрешения на доступ к файловой системе.
  • Исправлено зависание пользовательского интерфейса при перетаскивании в WinUI3.
  • Исправлена ошибка, из-за которой при доступе к локальной сети запускалось всплывающее окно оповещения о разрешениях.
  • Устранена проблема, из-за которой в дереве специальных возможностей появлялся дополнительный регион.
  • Исправлена проблема, из-за которой загрузки в стандартном фрейме браузера не работали.
Только пакет SDK
  • Исправлена ошибка BinSkim для WebView2Loader.dll.

Выпуск SDK 1.0.3537.50 для среды выполнения 141 (6 октября 2025 г.)

Дата выхода: 6 октября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3537.50

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 141.0.3537.50 или более поздней.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

Этот пакет SDK для выпуска включает следующие исправления ошибок.

Только среда выполнения
  • Исправлена ошибка, из-за которой при доступе к локальной сети запускалось всплывающее окно оповещения о разрешениях.
Только пакет SDK
  • Исправлена ошибка BinSkim для WebView2Loader.dll.

Предварительная версия пакета SDK 1.0.3530-prerelease для среды выполнения 141 (8 сентября 2025 г.)

Дата выхода: 8 сентября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3530 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, которая поставляется с Microsoft Edge версии 141.0.3530.0 или более поздней.

Общие изменения

Этот предварительный выпуск пакета SDK предназначен для улучшения работы WebView2 за счет скрытых улучшений.

  • Была укреплена инфраструктура тестирования.
  • Улучшена проверка API, чтобы обеспечить их надежную работу в различных сценариях.

Эти базовые улучшения обеспечивают стабильную, тщательно протестированную функциональность для создания приложений WebView2.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

В этот предварительный выпуск SDK не добавлены экспериментальные API.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Этот предварительный выпуск пакета SDK включает следующие исправления ошибок.

Только пакет SDK
  • Исправлена утечка памяти в контроллере композиции WPF.

Выпуск SDK 1.0.3485.44 для среды выполнения 140 (8 сентября 2025 г.)

Дата выхода: 8 сентября 2025 г.

Пакет NuGet для SDK WebView2 1.0.3485.44

Для полной совместимости с API этой версии выпуска пакета SDK WebView2 требуется среда выполнения WebView2 версии 140.0.3485.44 или более поздней.

Общие изменения

Этот пакет SDK для выпуска направлен на улучшение работы WebView2 за счет скрытых улучшений.

  • Была укреплена инфраструктура тестирования.
  • Улучшена проверка API, чтобы обеспечить их надежную работу в различных сценариях.

Эти базовые улучшения обеспечивают стабильную, тщательно протестированную функциональность для создания приложений WebView2.

Повышение до Фазы 3 (стабильная в выпуске)

Дополнительные API не были переведены с фазы 2: стабильная в предварительной версии на фазу 3: стабильная в выпуске в этом выпуске SDK.

Исправления ошибок

В этом пакете SDK для выпуска нет исправлений ошибок.

Предварительная версия пакета SDK 1.0.3477 — предварительная версия для среды выполнения 140 (11 августа 2025 г.)

Дата выхода: 11 августа 2025 г.

Пакет NuGet для SDK WebView2 1.0.3477 — предварительная версия

Для полной совместимости с API этой предварительной версии пакета SDK WebView2 требуется среда выполнения WebView2, поставляемая с Microsoft Edge версии 140.0.3477.0 или более поздней.

Экспериментальные API (этап 1: экспериментальный в предварительном выпуске)

В этот предварительный выпуск SDK не добавлены экспериментальные API.

Акции до фазы 2 (стабильная в предварительной версии)

Ни один API не был переведен с фазы 1: экспериментальная в предварительной версии на фазу 2: стабильная в предварительной версии в этом предварительном выпуске SDK.

Исправления ошибок

Только среда выполнения
  • Исправлено put_UserAgent , что не работает для служебных сценариев.
  • Исправлен сбой в средствах разработчика в Windows Server и Windows 10.
  • Удалено отслеживание процесса браузера после вызова remove_BrowserProcessExited.
  • Устранена проблема утечки памяти в hostObject асинхронных вызовах функций.
  • Исправлен сенсорный ввод, не работающий в визуальном хостинге после долгого нажатия.

См. также

Справочник по API:

  • Last updated on