interface ICoreWebView2ExperimentalProfile4

Article
05/02/2022

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

Note

This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.

interface ICoreWebView2ExperimentalProfile4
  : public IUnknown

Experimental Profile interface for Clear Browsing Data.

Summary

Members	Descriptions
ClearBrowsingData	Clear browsing data based on a data type.
ClearBrowsingDataAll	ClearBrowsingDataAll behaves like ClearBrowsingData except that it clears the entirety of the data associated with the profile it is called on.
ClearBrowsingDataInTimeRange	ClearBrowsingDataInTimeRange behaves like ClearBrowsingData except that it takes in two additional parameters for the start and end time for which it should clear the data between.

Applies to

Product	Introduced
WebView2 Win32	N/A
WebView2 Win32 Prerelease	1.0.1133

Members

ClearBrowsingData

Clear browsing data based on a data type.

public HRESULT ClearBrowsingData(COREWEBVIEW2_BROWSING_DATA_KINDS dataKinds, ICoreWebView2ExperimentalClearBrowsingDataCompletedHandler * handler)

This method takes two parameters, the first being a mask of one or more COREWEBVIEW2_BROWSING_DATA_KINDS. Or operation(s) can be applied to multiple COREWEBVIEW2_BROWSING_DATA_KINDS to create a mask representing those data types. The browsing data kinds that are supported are listed below. These data kinds follow a hierarchical structure in which nested bullet points are included in their parent bullet point's data kind. Ex: All DOM storage is encompassed in all site data which is encompassed in all profile data.

All Profile
All Site Data
All DOM Storage: File Systems, Indexed DB, Local Storage, Web SQL, Cache Storage
Cookies
Disk Cache
Download History
General Autofill
Password Autosave
Browsing History
Settings

The completed handler will be invoked when the browsing data has been cleared and will indicate if the specified data was properly cleared. In the case in which the operation is interrupted and the corresponding data is not fully cleared the handler will return E_ABORT and otherwise will return S_OK. Because this is an asynchronous operation, code that is dependent on the cleared data must be placed in the callback of this operation. If the WebView object is closed before the clear browsing data operation has completed, the handler will be released, but not invoked. In this case the clear browsing data operation may or may not be completed. ClearBrowsingData clears the dataKinds regardless of timestamp.

ClearBrowsingDataAll

ClearBrowsingDataAll behaves like ClearBrowsingData except that it clears the entirety of the data associated with the profile it is called on.

public HRESULT ClearBrowsingDataAll(ICoreWebView2ExperimentalClearBrowsingDataCompletedHandler * handler)

It clears the data regardless of timestamp.

bool AppWindow::ClearBrowsingData(COREWEBVIEW2_BROWSING_DATA_KINDS dataKinds)
{
    auto webView2_12 = m_webView.try_query<ICoreWebView2_12>();
    CHECK_FEATURE_RETURN(webView2_12);
    wil::com_ptr<ICoreWebView2Profile> webView2Profile;
    CHECK_FAILURE(webView2_12->get_Profile(&webView2Profile));
    CHECK_FEATURE_RETURN(webView2Profile);
    auto webView2ExperimentalProfile4 =
        webView2Profile.try_query<ICoreWebView2ExperimentalProfile4>();
    CHECK_FEATURE_RETURN(webView2ExperimentalProfile4);
    // Clear the browsing data from the last hour.
    double endTime = (double)std::time(nullptr);
    double startTime = endTime - 3600.0;
    CHECK_FAILURE(webView2ExperimentalProfile4->ClearBrowsingDataInTimeRange(
        dataKinds, startTime, endTime,
        Callback<ICoreWebView2ExperimentalClearBrowsingDataCompletedHandler>(
            [this](HRESULT error) -> HRESULT {
                AsyncMessageBox(L"Completed", L"Clear Browsing Data");
                return S_OK;
            })
            .Get()));
    return true;
}

ClearBrowsingDataInTimeRange

ClearBrowsingDataInTimeRange behaves like ClearBrowsingData except that it takes in two additional parameters for the start and end time for which it should clear the data between.

public HRESULT ClearBrowsingDataInTimeRange(COREWEBVIEW2_BROWSING_DATA_KINDS dataKinds, double startTime, double endTime, ICoreWebView2ExperimentalClearBrowsingDataCompletedHandler * handler)

The startTime and endTime parameters correspond to the number of seconds since the UNIX epoch. startTime is inclusive while endTime is exclusive, therefore the data will be cleared between [startTime, endTime).

Partager via