@girs/webkit-6.0 2.40.0-3.2.0 → 2.41.90-3.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  ![downloads/week](https://img.shields.io/npm/dw/@girs/webkit-6.0)
6
6
 
7
7
 
8
- GJS TypeScript type definitions for WebKit-6.0, generated from library version 2.40.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.0.
8
+ GJS TypeScript type definitions for WebKit-6.0, generated from library version 2.41.90 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.2.
9
9
 
10
10
  WebKitGTK+ is a full-featured port of the WebKit rendering engine, suitable for projects requiring any kind of web integration, from hybrid HTML/CSS applications to full-fledged web browsers.
11
11
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@girs/webkit-6.0",
3
- "version": "2.40.0-3.2.0",
4
- "description": "GJS TypeScript type definitions for WebKit-6.0, generated from library version 2.40.0",
3
+ "version": "2.41.90-3.2.2",
4
+ "description": "GJS TypeScript type definitions for WebKit-6.0, generated from library version 2.41.90",
5
5
  "type": "module",
6
6
  "module": "webkit-6.0.js",
7
7
  "main": "webkit-6.0.js",
@@ -25,23 +25,23 @@
25
25
  "test:cjs": "NODE_OPTIONS=--max_old_space_size=9216 tsc --noEmit webkit-6.0.d.cts"
26
26
  },
27
27
  "dependencies": {
28
- "@girs/cairo-1.0": "^1.0.0-3.2.0",
29
- "@girs/freetype2-2.0": "^2.0.0-3.2.0",
30
- "@girs/gdk-4.0": "^4.0.0-3.2.0",
31
- "@girs/gdkpixbuf-2.0": "^2.0.0-3.2.0",
32
- "@girs/gio-2.0": "^2.76.1-3.2.0",
33
- "@girs/gjs": "^3.2.0",
34
- "@girs/glib-2.0": "^2.76.1-3.2.0",
35
- "@girs/gmodule-2.0": "^2.0.0-3.2.0",
36
- "@girs/gobject-2.0": "^2.76.1-3.2.0",
37
- "@girs/graphene-1.0": "^1.0.0-3.2.0",
38
- "@girs/gsk-4.0": "^4.0.0-3.2.0",
39
- "@girs/gtk-4.0": "^4.10.4-3.2.0",
40
- "@girs/harfbuzz-0.0": "^7.1.0-3.2.0",
41
- "@girs/javascriptcore-6.0": "^2.40.0-3.2.0",
42
- "@girs/pango-1.0": "^1.50.14-3.2.0",
43
- "@girs/pangocairo-1.0": "^1.0.0-3.2.0",
44
- "@girs/soup-3.0": "^3.4.2-3.2.0"
28
+ "@girs/cairo-1.0": "^1.0.0-3.2.2",
29
+ "@girs/freetype2-2.0": "^2.0.0-3.2.2",
30
+ "@girs/gdk-4.0": "^4.0.0-3.2.2",
31
+ "@girs/gdkpixbuf-2.0": "^2.0.0-3.2.2",
32
+ "@girs/gio-2.0": "^2.77.0-3.2.2",
33
+ "@girs/gjs": "^3.2.2",
34
+ "@girs/glib-2.0": "^2.77.0-3.2.2",
35
+ "@girs/gmodule-2.0": "^2.0.0-3.2.2",
36
+ "@girs/gobject-2.0": "^2.77.0-3.2.2",
37
+ "@girs/graphene-1.0": "^1.0.0-3.2.2",
38
+ "@girs/gsk-4.0": "^4.0.0-3.2.2",
39
+ "@girs/gtk-4.0": "^4.12.0-3.2.2",
40
+ "@girs/harfbuzz-0.0": "^7.1.0-3.2.2",
41
+ "@girs/javascriptcore-6.0": "^2.40.0-3.2.2",
42
+ "@girs/pango-1.0": "^1.51.0-3.2.2",
43
+ "@girs/pangocairo-1.0": "^1.0.0-3.2.2",
44
+ "@girs/soup-3.0": "^3.4.2-3.2.2"
45
45
  },
46
46
  "devDependencies": {
47
47
  "typescript": "*"
package/typedoc.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "entryPoints": ["./webkit-6.0.d.ts","./webkit-6.0-ambient.d.ts","./webkit-6.0-import.d.ts"],
2
+ "entryPoints": ["./webkit-6.0.d.ts"],
3
3
  "readme": "./README.md",
4
4
  "name": "WebKit-6.0",
5
5
  "tsconfig": "./tsconfig.json"
package/webkit-6.0.d.cts CHANGED
@@ -405,6 +405,61 @@ export enum FaviconDatabaseError {
405
405
  */
406
406
  FAVICON_UNKNOWN,
407
407
  }
408
+ /**
409
+ * Describes the status of a [struct`WebKitFeature]`.
410
+ *
411
+ * The status for a given feature can be obtained with
412
+ * [id`webkit_feature_get_status]`.
413
+ */
414
+ export enum FeatureStatus {
415
+ /**
416
+ * Feature that adjust behaviour for
417
+ * specific application needs. The feature is not part of a Web platform
418
+ * feature, not a mature feature intended to be always on.
419
+ */
420
+ EMBEDDER,
421
+ /**
422
+ * Feature in development. The feature
423
+ * may be unfinished, and there are no guarantees about its safety and
424
+ * stability.
425
+ */
426
+ UNSTABLE,
427
+ /**
428
+ * Feature for debugging the WebKit engine.
429
+ * The feature is not generally useful for user or web developers, and
430
+ * always disabled by default.
431
+ */
432
+ INTERNAL,
433
+ /**
434
+ * Feature for web developers. The feature
435
+ * is not generally useful for end users, and always disabled by default.
436
+ */
437
+ DEVELOPER,
438
+ /**
439
+ * Feature in active development and
440
+ * complete enough for testing. The feature may not be yet ready to
441
+ * ship and is disabled by default.
442
+ */
443
+ TESTABLE,
444
+ /**
445
+ * Feature ready to be tested by users.
446
+ * The feature is disabled by default, but may be enabled by applications
447
+ * automatically e.g. in their “technology preview” or “beta” versions.
448
+ */
449
+ PREVIEW,
450
+ /**
451
+ * Feature ready for general use. The
452
+ * feature is enabled by default, but it may still be toggled to support
453
+ * debugging and testing.
454
+ */
455
+ STABLE,
456
+ /**
457
+ * Feature in general use. The feature is
458
+ * always enabled and in general there should be no user-facing interface
459
+ * to toggle it.
460
+ */
461
+ MATURE,
462
+ }
408
463
  /**
409
464
  * Enum values used for determining the hardware acceleration policy.
410
465
  */
@@ -1865,6 +1920,49 @@ export class BackForwardListItem extends GObject.InitiallyUnowned {
1865
1920
  _init(config?: BackForwardListItem.ConstructorProperties): void
1866
1921
  }
1867
1922
 
1923
+ export module ClipboardPermissionRequest {
1924
+
1925
+ // Constructor properties interface
1926
+
1927
+ export interface ConstructorProperties extends PermissionRequest.ConstructorProperties, GObject.Object.ConstructorProperties {
1928
+ }
1929
+
1930
+ }
1931
+
1932
+ export interface ClipboardPermissionRequest extends PermissionRequest {
1933
+
1934
+ // Class property signals of WebKit-6.0.WebKit.ClipboardPermissionRequest
1935
+
1936
+ connect(sigName: string, callback: (...args: any[]) => void): number
1937
+ connect_after(sigName: string, callback: (...args: any[]) => void): number
1938
+ emit(sigName: string, ...args: any[]): void
1939
+ disconnect(id: number): void
1940
+ }
1941
+
1942
+ /**
1943
+ * A permission request for reading clipboard contents.
1944
+ *
1945
+ * WebKitClipboardPermissionRequest represents a request for
1946
+ * permission to decide whether WebKit can access the clipboard to read
1947
+ * its contents through the Async Clipboard API.
1948
+ *
1949
+ * When a WebKitClipboardPermissionRequest is not handled by the user,
1950
+ * it is denied by default.
1951
+ * @class
1952
+ */
1953
+ export class ClipboardPermissionRequest extends GObject.Object {
1954
+
1955
+ // Own properties of WebKit-6.0.WebKit.ClipboardPermissionRequest
1956
+
1957
+ static name: string
1958
+ static $gtype: GObject.GType<ClipboardPermissionRequest>
1959
+
1960
+ // Constructors of WebKit-6.0.WebKit.ClipboardPermissionRequest
1961
+
1962
+ constructor(config?: ClipboardPermissionRequest.ConstructorProperties)
1963
+ _init(config?: ClipboardPermissionRequest.ConstructorProperties): void
1964
+ }
1965
+
1868
1966
  export module ColorChooserRequest {
1869
1967
 
1870
1968
  // Signal callback interfaces
@@ -2383,6 +2481,24 @@ export interface CookieManager {
2383
2481
  * @returns the cookie acceptance policy of @cookie_manager as a #WebKitCookieAcceptPolicy.
2384
2482
  */
2385
2483
  get_accept_policy_finish(result: Gio.AsyncResult): CookieAcceptPolicy
2484
+ /**
2485
+ * Asynchronously get a list of #SoupCookie from `cookie_manager`.
2486
+ *
2487
+ * When the operation is finished, `callback` will be called. You can then call
2488
+ * webkit_cookie_manager_get_all_cookies_finish() to get the result of the operation.
2489
+ * @param cancellable a #GCancellable or %NULL to ignore
2490
+ * @param callback (closure user_data): a #GAsyncReadyCallback to call when the request is satisfied
2491
+ */
2492
+ get_all_cookies(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void
2493
+ /**
2494
+ * Finish an asynchronous operation started with webkit_cookie_manager_get_all_cookies().
2495
+ *
2496
+ * The return value is a #GSList of #SoupCookie instances which should be released
2497
+ * with g_list_free_full() and soup_cookie_free().
2498
+ * @param result a #GAsyncResult
2499
+ * @returns A #GList of #SoupCookie instances.
2500
+ */
2501
+ get_all_cookies_finish(result: Gio.AsyncResult): Soup.Cookie[]
2386
2502
  /**
2387
2503
  * Asynchronously get a list of #SoupCookie from `cookie_manager`.
2388
2504
  *
@@ -2405,6 +2521,22 @@ export interface CookieManager {
2405
2521
  * @returns A #GList of #SoupCookie instances.
2406
2522
  */
2407
2523
  get_cookies_finish(result: Gio.AsyncResult): Soup.Cookie[]
2524
+ /**
2525
+ * Asynchronously replace all cookies in `cookie_manager` with the given list of `cookies`.
2526
+ *
2527
+ * When the operation is finished, `callback` will be called. You can then call
2528
+ * webkit_cookie_manager_replace_cookies_finish() to get the result of the operation.
2529
+ * @param cookies a #GList of #SoupCookie to be added
2530
+ * @param cancellable a #GCancellable or %NULL to ignore
2531
+ * @param callback (closure user_data): a #GAsyncReadyCallback to call when the request is satisfied
2532
+ */
2533
+ replace_cookies(cookies: Soup.Cookie[], cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void
2534
+ /**
2535
+ * Finish an asynchronous operation started with webkit_cookie_manager_replace_cookies().
2536
+ * @param result a #GAsyncResult
2537
+ * @returns %TRUE if the cookies were added or %FALSE in case of error.
2538
+ */
2539
+ replace_cookies_finish(result: Gio.AsyncResult): boolean
2408
2540
  /**
2409
2541
  * Set the cookie acceptance policy of `cookie_manager` as `policy`.
2410
2542
  *
@@ -5517,8 +5649,7 @@ export module Settings {
5517
5649
  */
5518
5650
  javascript_can_open_windows_automatically?: boolean | null
5519
5651
  /**
5520
- * Determines whether a site can load favicons irrespective
5521
- * of the value of #WebKitSettings:auto-load-images.
5652
+ * Unsupported setting. This property does nothing.
5522
5653
  */
5523
5654
  load_icons_ignoring_image_load_setting?: boolean | null
5524
5655
  /**
@@ -5874,8 +6005,7 @@ export interface Settings {
5874
6005
  */
5875
6006
  javascript_can_open_windows_automatically: boolean
5876
6007
  /**
5877
- * Determines whether a site can load favicons irrespective
5878
- * of the value of #WebKitSettings:auto-load-images.
6008
+ * Unsupported setting. This property does nothing.
5879
6009
  */
5880
6010
  load_icons_ignoring_image_load_setting: boolean
5881
6011
  /**
@@ -6144,6 +6274,12 @@ export interface Settings {
6144
6274
  * @returns The default font family used to display content marked with fantasy font.
6145
6275
  */
6146
6276
  get_fantasy_font_family(): string | null
6277
+ /**
6278
+ * Gets whether a feature is enabled.
6279
+ * @param feature the feature to toggle.
6280
+ * @returns Whether the feature is enabled.
6281
+ */
6282
+ get_feature_enabled(feature: Feature): boolean
6147
6283
  /**
6148
6284
  * Get the #WebKitSettings:hardware-acceleration-policy property.
6149
6285
  * @returns a #WebKitHardwareAccelerationPolicy
@@ -6160,8 +6296,8 @@ export interface Settings {
6160
6296
  */
6161
6297
  get_javascript_can_open_windows_automatically(): boolean
6162
6298
  /**
6163
- * Get the #WebKitSettings:load-icons-ignoring-image-load-setting property.
6164
- * @returns %TRUE If site icon can be loaded irrespective of image loading preference or %FALSE otherwise.
6299
+ * Setting no longer supported. This function returns %FALSE.
6300
+ * @returns %FALSE
6165
6301
  */
6166
6302
  get_load_icons_ignoring_image_load_setting(): boolean
6167
6303
  /**
@@ -6421,6 +6557,17 @@ export interface Settings {
6421
6557
  * @param fantasy_font_family the new default fantasy font family
6422
6558
  */
6423
6559
  set_fantasy_font_family(fantasy_font_family: string | null): void
6560
+ /**
6561
+ * Enables or disables a feature.
6562
+ *
6563
+ * The current status of the feature can be determined with
6564
+ * [id`webkit_settings_get_feature_enabled]`. To reset a feature to its
6565
+ * initial status, pass the value returned by
6566
+ * [id`webkit_feature_get_default_value]` as the `enabled` parameter.
6567
+ * @param feature the feature to toggle.
6568
+ * @param enabled whether the feature will be enabled.
6569
+ */
6570
+ set_feature_enabled(feature: Feature, enabled: boolean): void
6424
6571
  /**
6425
6572
  * Set the #WebKitSettings:hardware-acceleration-policy property.
6426
6573
  * @param policy a #WebKitHardwareAccelerationPolicy
@@ -6437,7 +6584,7 @@ export interface Settings {
6437
6584
  */
6438
6585
  set_javascript_can_open_windows_automatically(enabled: boolean): void
6439
6586
  /**
6440
- * Set the #WebKitSettings:load-icons-ignoring-image-load-setting property.
6587
+ * Setting no longer supported. This function does nothing.
6441
6588
  * @param enabled Value to be set
6442
6589
  */
6443
6590
  set_load_icons_ignoring_image_load_setting(enabled: boolean): void
@@ -6746,6 +6893,40 @@ export class Settings extends GObject.Object {
6746
6893
  * @returns the equivalent font size in points.
6747
6894
  */
6748
6895
  static font_size_to_points(pixels: number): number
6896
+ /**
6897
+ * Gets the list of all available WebKit features.
6898
+ *
6899
+ * Features can be toggled with [method`Settings`.set_feature_enabled],
6900
+ * and their current state determined with
6901
+ * [method`Settings`.get_feature_enabled].
6902
+ *
6903
+ * Note that most applications should use
6904
+ * [func`Settings`.get_development_features] and
6905
+ * [func`Settings`.get_experimental_features] instead.
6906
+ * @returns List of all features.
6907
+ */
6908
+ static get_all_features(): FeatureList
6909
+ /**
6910
+ * Gets the list of available development WebKit features.
6911
+ *
6912
+ * The returned features are a subset of those returned by
6913
+ * [func`Settings`.get_all_features], and includes those which
6914
+ * web and WebKit developers might find useful, but in general should
6915
+ * *not* be exposed to end users; see [enum`FeatureStatus]` for
6916
+ * more details.
6917
+ * @returns List of development features.
6918
+ */
6919
+ static get_development_features(): FeatureList
6920
+ /**
6921
+ * Gets the list of available experimental WebKit features.
6922
+ *
6923
+ * The returned features are a subset of those returned by
6924
+ * [func`Settings`.get_all_features], and includes those which
6925
+ * certain applications may want to expose to end users; see
6926
+ * [enum`FeatureStatus]` for more details.
6927
+ * @returns List of experimental features.
6928
+ */
6929
+ static get_experimental_features(): FeatureList
6749
6930
  }
6750
6931
 
6751
6932
  export module URIRequest {
@@ -7468,8 +7649,8 @@ export interface UserContentManager {
7468
7649
  *
7469
7650
  * The registered handler can be unregistered by using
7470
7651
  * webkit_user_content_manager_unregister_script_message_handler().
7471
- * @param name Name of the script message channel `world_name` (nullable): the name of a #WebKitScriptWorld
7472
- * @param world_name
7652
+ * @param name Name of the script message channel
7653
+ * @param world_name the name of a #WebKitScriptWorld
7473
7654
  * @returns %TRUE if message handler was registered successfully, or %FALSE otherwise.
7474
7655
  */
7475
7656
  register_script_message_handler(name: string | null, world_name: string | null): boolean
@@ -10487,6 +10668,20 @@ export module WebsiteDataManager {
10487
10668
  * parameters to configure data directories will be ignored.
10488
10669
  */
10489
10670
  is_ephemeral?: boolean | null
10671
+ /**
10672
+ * The percentage of volume space that can be used for data storage for every domain.
10673
+ * If the maximum storage is reached the storage request will fail with a QuotaExceededError exception.
10674
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10675
+ * means WebKit will use the default quota (1 GiB).
10676
+ */
10677
+ origin_storage_ratio?: number | null
10678
+ /**
10679
+ * The percentage of volume space that can be used for data storage for all domains.
10680
+ * If the maximum storage is reached the eviction will happen.
10681
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10682
+ * means there's no limit for the total storage.
10683
+ */
10684
+ total_storage_ratio?: number | null
10490
10685
  }
10491
10686
 
10492
10687
  }
@@ -10510,6 +10705,20 @@ export interface WebsiteDataManager {
10510
10705
  * parameters to configure data directories will be ignored.
10511
10706
  */
10512
10707
  readonly is_ephemeral: boolean
10708
+ /**
10709
+ * The percentage of volume space that can be used for data storage for every domain.
10710
+ * If the maximum storage is reached the storage request will fail with a QuotaExceededError exception.
10711
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10712
+ * means WebKit will use the default quota (1 GiB).
10713
+ */
10714
+ readonly origin_storage_ratio: number
10715
+ /**
10716
+ * The percentage of volume space that can be used for data storage for all domains.
10717
+ * If the maximum storage is reached the eviction will happen.
10718
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10719
+ * means there's no limit for the total storage.
10720
+ */
10721
+ readonly total_storage_ratio: number
10513
10722
 
10514
10723
  // Owm methods of WebKit-6.0.WebKit.WebsiteDataManager
10515
10724
 
@@ -10631,6 +10840,12 @@ export interface WebsiteDataManager {
10631
10840
  connect(sigName: "notify::is-ephemeral", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10632
10841
  connect_after(sigName: "notify::is-ephemeral", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10633
10842
  emit(sigName: "notify::is-ephemeral", ...args: any[]): void
10843
+ connect(sigName: "notify::origin-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10844
+ connect_after(sigName: "notify::origin-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10845
+ emit(sigName: "notify::origin-storage-ratio", ...args: any[]): void
10846
+ connect(sigName: "notify::total-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10847
+ connect_after(sigName: "notify::total-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10848
+ emit(sigName: "notify::total-storage-ratio", ...args: any[]): void
10634
10849
  connect(sigName: string, callback: (...args: any[]) => void): number
10635
10850
  connect_after(sigName: string, callback: (...args: any[]) => void): number
10636
10851
  emit(sigName: string, ...args: any[]): void
@@ -10643,18 +10858,11 @@ export interface WebsiteDataManager {
10643
10858
  * You can use WebKitWebsiteDataManager to configure the local directories
10644
10859
  * where website data will be stored. Use #WebKitWebsiteDataManager:base-data-directory
10645
10860
  * and #WebKitWebsiteDataManager:base-cache-directory set a common base directory for all
10646
- * website data and caches. The newly created WebKitWebsiteDataManager must be passed as
10647
- * a construct property to a #WebKitWebContext; you can use webkit_web_context_new_with_website_data_manager()
10648
- * to create a new #WebKitWebContext with a WebKitWebsiteDataManager.
10649
- * If you don't want to set any specific configuration, you don't need to create
10650
- * a WebKitWebsiteDataManager: the #WebKitWebContext will create a WebKitWebsiteDataManager
10651
- * with the default configuration. To get the WebKitWebsiteDataManager of a #WebKitWebContext,
10652
- * you can use webkit_web_context_get_website_data_manager().
10861
+ * website data and caches.
10653
10862
  *
10654
- * A WebKitWebsiteDataManager can also be ephemeral, in which case all the directory configuration
10863
+ * A WebKitWebsiteDataManager can be ephemeral, in which case all the directory configuration
10655
10864
  * is not needed because website data will never persist. You can create an ephemeral WebKitWebsiteDataManager
10656
- * with webkit_website_data_manager_new_ephemeral() and pass the ephemeral WebKitWebsiteDataManager to
10657
- * a #WebKitWebContext, or simply use webkit_web_context_new_ephemeral().
10865
+ * with webkit_website_data_manager_new_ephemeral().
10658
10866
  *
10659
10867
  * WebKitWebsiteDataManager can also be used to fetch website data, remove data
10660
10868
  * stored by particular websites, or clear data for all websites modified since a given
@@ -11112,6 +11320,20 @@ export abstract class BackForwardListItemClass {
11112
11320
  static name: string
11113
11321
  }
11114
11322
 
11323
+ export interface ClipboardPermissionRequestClass {
11324
+
11325
+ // Own fields of WebKit-6.0.WebKit.ClipboardPermissionRequestClass
11326
+
11327
+ parent_class: GObject.ObjectClass
11328
+ }
11329
+
11330
+ export abstract class ClipboardPermissionRequestClass {
11331
+
11332
+ // Own properties of WebKit-6.0.WebKit.ClipboardPermissionRequestClass
11333
+
11334
+ static name: string
11335
+ }
11336
+
11115
11337
  export interface ColorChooserRequestClass {
11116
11338
 
11117
11339
  // Own fields of WebKit-6.0.WebKit.ColorChooserRequestClass
@@ -11316,6 +11538,182 @@ export abstract class FaviconDatabaseClass {
11316
11538
  static name: string
11317
11539
  }
11318
11540
 
11541
+ export interface Feature {
11542
+
11543
+ // Owm methods of WebKit-6.0.WebKit.Feature
11544
+
11545
+ /**
11546
+ * Gets the category of the feature.
11547
+ *
11548
+ * Applications which include user interface to toggle features may want
11549
+ * to use the category to group related features together.
11550
+ * @returns Feature category.
11551
+ */
11552
+ get_category(): string | null
11553
+ /**
11554
+ * Gets whether the feature is enabled by default.
11555
+ *
11556
+ * The default value may be used by applications which include user interface
11557
+ * to toggle features to restore its settings to their defaults. Note that
11558
+ * whether a feature is actually enabled must be checked with
11559
+ * [method`Settings`.get_feature_enabled].
11560
+ * @returns Whether the feature is enabled by default.
11561
+ */
11562
+ get_default_value(): boolean
11563
+ /**
11564
+ * Gets a description for the `feature`.
11565
+ *
11566
+ * The detailed description should be considered an additional clarification
11567
+ * on the purpose of the feature, to be used as complementary aid to be
11568
+ * displayed along the feature name returned by [method`Feature`.get_name].
11569
+ * The returned string is suitable to be displayed to end users, but it
11570
+ * should not be relied upon being localized.
11571
+ *
11572
+ * Note that some *features may not* have a detailed description, and `NULL`
11573
+ * is returned in this case.
11574
+ * @returns Feature description.
11575
+ */
11576
+ get_details(): string | null
11577
+ /**
11578
+ * Gets a string that uniquely identifies the `feature`.
11579
+ * @returns The identifier string for the feature.
11580
+ */
11581
+ get_identifier(): string | null
11582
+ /**
11583
+ * Gets a short name for the `feature`.
11584
+ *
11585
+ * The returned string is suitable to be displayed to end users, but it
11586
+ * should not be relied upon being localized.
11587
+ *
11588
+ * Note that some *features may not* have a short name, and `NULL`
11589
+ * is returned in this case.
11590
+ * @returns Short feature name.
11591
+ */
11592
+ get_name(): string | null
11593
+ /**
11594
+ * Gets the status of the feature.
11595
+ * @returns Feature status.
11596
+ */
11597
+ get_status(): FeatureStatus
11598
+ /**
11599
+ * Atomically acquires a reference on the given `feature`.
11600
+ *
11601
+ * This function is MT-safe and may be called from any thread.
11602
+ * @returns The same @feature with an additional reference.
11603
+ */
11604
+ ref(): Feature
11605
+ /**
11606
+ * Atomically releases a reference on the given `feature`.
11607
+ *
11608
+ * If the reference was the last, the resources associated to the
11609
+ * `feature` are freed. This function is MT-safe and may be called from
11610
+ * any thread.
11611
+ */
11612
+ unref(): void
11613
+ }
11614
+
11615
+ /**
11616
+ * Describes a web engine feature that may be toggled at runtime.
11617
+ *
11618
+ * The WebKit web engine includes a set of features which may be toggled
11619
+ * programmatically, each one represented by a #WebKitFeature that provides
11620
+ * information about it:
11621
+ *
11622
+ * - A unique “identifier”: [method`Feature`.get_identifier].
11623
+ * - A “default value”, which indicates whether the option is enabled
11624
+ * automatically: [method`Feature`.get_default_value].
11625
+ * - Its “status”, which determines whether it should be considered
11626
+ * user-settable and its development stage (see [enum`FeatureStatus]`
11627
+ * for details): [method`Feature`.get_status].
11628
+ * - A category, which may be used to group features together:
11629
+ * [method`Feature`.get_category].
11630
+ * - An optional short “name” which can be presented to an user:
11631
+ * [method`Feature`.get_name].
11632
+ * - An optional longer “detailed” description:
11633
+ * [method`Feature`.get_details].
11634
+ *
11635
+ * The lists of available features can be obtained with
11636
+ * [func`Settings`.get_all_features], [func`Settings`.get_experimental_features],
11637
+ * and [func`Settings`.get_development_features]). As a rule of thumb,
11638
+ * applications which may want to allow users (i.e. web developers) to test
11639
+ * WebKit features should use the list of experimental features. Additionally,
11640
+ * applications might want to expose development features *when targeting
11641
+ * technically inclined users* for early testing of in-development features
11642
+ * (i.e. in “technology preview” or “canary” builds).
11643
+ *
11644
+ * Applications **must not** expose the list of all features to end users
11645
+ * because they often lack descriptions and control parts of the web engine
11646
+ * which are either intended to be used during development of WebKit itself,
11647
+ * or in specific scenarios to tweak how WebKit integrates with the
11648
+ * application.
11649
+ * @record
11650
+ */
11651
+ export class Feature {
11652
+
11653
+ // Own properties of WebKit-6.0.WebKit.Feature
11654
+
11655
+ static name: string
11656
+ }
11657
+
11658
+ export interface FeatureList {
11659
+
11660
+ // Owm methods of WebKit-6.0.WebKit.FeatureList
11661
+
11662
+ /**
11663
+ * Gets a feature given its index.
11664
+ * @param index index of the feature
11665
+ * @returns The feature at @index.
11666
+ */
11667
+ get(index: number): Feature
11668
+ /**
11669
+ * Gets the number of elements in the feature list.
11670
+ * @returns number of elements. Since 2.42
11671
+ */
11672
+ get_length(): number
11673
+ /**
11674
+ * Atomically acquires a reference on the given `feature_list`.
11675
+ *
11676
+ * This function is MT-safe and may be called from any thread.
11677
+ * @returns The same @feature_list with an additional reference.
11678
+ */
11679
+ ref(): FeatureList
11680
+ /**
11681
+ * Atomically releases a reference on the given `feature_list`.
11682
+ *
11683
+ * If the reference was the last, the resources associated to the
11684
+ * `feature_list` are freed. This function is MT-safe and may be called
11685
+ * from any thread.
11686
+ */
11687
+ unref(): void
11688
+ }
11689
+
11690
+ /**
11691
+ * Contains a set of toggle-able web engine features.
11692
+ *
11693
+ * The list supports passing around a set of [struct`Feature]` objects and
11694
+ * iterating over them:
11695
+ *
11696
+ * ```c
11697
+ * g_autoptr(WebKitFeatureList) list = webkit_settings_get_experimental_features();
11698
+ * for (gsize i = 0; i < webkit_feature_list_get_length(list): i++) {
11699
+ * WebKitFeature *feature = webkit_feature_list_get(list, i);
11700
+ * // Do something with "feature".
11701
+ * }
11702
+ * ```
11703
+ *
11704
+ * Lists of features can be obtained with
11705
+ * [func`Settings`.get_experimental_features],
11706
+ * [func`Settings`.get_development_features], and
11707
+ * [func`Settings`.get_all_features].
11708
+ * @record
11709
+ */
11710
+ export class FeatureList {
11711
+
11712
+ // Own properties of WebKit-6.0.WebKit.FeatureList
11713
+
11714
+ static name: string
11715
+ }
11716
+
11319
11717
  export interface FileChooserRequestClass {
11320
11718
 
11321
11719
  // Own fields of WebKit-6.0.WebKit.FileChooserRequestClass
package/webkit-6.0.d.ts CHANGED
@@ -407,6 +407,61 @@ enum FaviconDatabaseError {
407
407
  */
408
408
  FAVICON_UNKNOWN,
409
409
  }
410
+ /**
411
+ * Describes the status of a [struct`WebKitFeature]`.
412
+ *
413
+ * The status for a given feature can be obtained with
414
+ * [id`webkit_feature_get_status]`.
415
+ */
416
+ enum FeatureStatus {
417
+ /**
418
+ * Feature that adjust behaviour for
419
+ * specific application needs. The feature is not part of a Web platform
420
+ * feature, not a mature feature intended to be always on.
421
+ */
422
+ EMBEDDER,
423
+ /**
424
+ * Feature in development. The feature
425
+ * may be unfinished, and there are no guarantees about its safety and
426
+ * stability.
427
+ */
428
+ UNSTABLE,
429
+ /**
430
+ * Feature for debugging the WebKit engine.
431
+ * The feature is not generally useful for user or web developers, and
432
+ * always disabled by default.
433
+ */
434
+ INTERNAL,
435
+ /**
436
+ * Feature for web developers. The feature
437
+ * is not generally useful for end users, and always disabled by default.
438
+ */
439
+ DEVELOPER,
440
+ /**
441
+ * Feature in active development and
442
+ * complete enough for testing. The feature may not be yet ready to
443
+ * ship and is disabled by default.
444
+ */
445
+ TESTABLE,
446
+ /**
447
+ * Feature ready to be tested by users.
448
+ * The feature is disabled by default, but may be enabled by applications
449
+ * automatically e.g. in their “technology preview” or “beta” versions.
450
+ */
451
+ PREVIEW,
452
+ /**
453
+ * Feature ready for general use. The
454
+ * feature is enabled by default, but it may still be toggled to support
455
+ * debugging and testing.
456
+ */
457
+ STABLE,
458
+ /**
459
+ * Feature in general use. The feature is
460
+ * always enabled and in general there should be no user-facing interface
461
+ * to toggle it.
462
+ */
463
+ MATURE,
464
+ }
410
465
  /**
411
466
  * Enum values used for determining the hardware acceleration policy.
412
467
  */
@@ -1867,6 +1922,49 @@ class BackForwardListItem extends GObject.InitiallyUnowned {
1867
1922
  _init(config?: BackForwardListItem.ConstructorProperties): void
1868
1923
  }
1869
1924
 
1925
+ module ClipboardPermissionRequest {
1926
+
1927
+ // Constructor properties interface
1928
+
1929
+ interface ConstructorProperties extends PermissionRequest.ConstructorProperties, GObject.Object.ConstructorProperties {
1930
+ }
1931
+
1932
+ }
1933
+
1934
+ interface ClipboardPermissionRequest extends PermissionRequest {
1935
+
1936
+ // Class property signals of WebKit-6.0.WebKit.ClipboardPermissionRequest
1937
+
1938
+ connect(sigName: string, callback: (...args: any[]) => void): number
1939
+ connect_after(sigName: string, callback: (...args: any[]) => void): number
1940
+ emit(sigName: string, ...args: any[]): void
1941
+ disconnect(id: number): void
1942
+ }
1943
+
1944
+ /**
1945
+ * A permission request for reading clipboard contents.
1946
+ *
1947
+ * WebKitClipboardPermissionRequest represents a request for
1948
+ * permission to decide whether WebKit can access the clipboard to read
1949
+ * its contents through the Async Clipboard API.
1950
+ *
1951
+ * When a WebKitClipboardPermissionRequest is not handled by the user,
1952
+ * it is denied by default.
1953
+ * @class
1954
+ */
1955
+ class ClipboardPermissionRequest extends GObject.Object {
1956
+
1957
+ // Own properties of WebKit-6.0.WebKit.ClipboardPermissionRequest
1958
+
1959
+ static name: string
1960
+ static $gtype: GObject.GType<ClipboardPermissionRequest>
1961
+
1962
+ // Constructors of WebKit-6.0.WebKit.ClipboardPermissionRequest
1963
+
1964
+ constructor(config?: ClipboardPermissionRequest.ConstructorProperties)
1965
+ _init(config?: ClipboardPermissionRequest.ConstructorProperties): void
1966
+ }
1967
+
1870
1968
  module ColorChooserRequest {
1871
1969
 
1872
1970
  // Signal callback interfaces
@@ -2385,6 +2483,24 @@ interface CookieManager {
2385
2483
  * @returns the cookie acceptance policy of @cookie_manager as a #WebKitCookieAcceptPolicy.
2386
2484
  */
2387
2485
  get_accept_policy_finish(result: Gio.AsyncResult): CookieAcceptPolicy
2486
+ /**
2487
+ * Asynchronously get a list of #SoupCookie from `cookie_manager`.
2488
+ *
2489
+ * When the operation is finished, `callback` will be called. You can then call
2490
+ * webkit_cookie_manager_get_all_cookies_finish() to get the result of the operation.
2491
+ * @param cancellable a #GCancellable or %NULL to ignore
2492
+ * @param callback (closure user_data): a #GAsyncReadyCallback to call when the request is satisfied
2493
+ */
2494
+ get_all_cookies(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void
2495
+ /**
2496
+ * Finish an asynchronous operation started with webkit_cookie_manager_get_all_cookies().
2497
+ *
2498
+ * The return value is a #GSList of #SoupCookie instances which should be released
2499
+ * with g_list_free_full() and soup_cookie_free().
2500
+ * @param result a #GAsyncResult
2501
+ * @returns A #GList of #SoupCookie instances.
2502
+ */
2503
+ get_all_cookies_finish(result: Gio.AsyncResult): Soup.Cookie[]
2388
2504
  /**
2389
2505
  * Asynchronously get a list of #SoupCookie from `cookie_manager`.
2390
2506
  *
@@ -2407,6 +2523,22 @@ interface CookieManager {
2407
2523
  * @returns A #GList of #SoupCookie instances.
2408
2524
  */
2409
2525
  get_cookies_finish(result: Gio.AsyncResult): Soup.Cookie[]
2526
+ /**
2527
+ * Asynchronously replace all cookies in `cookie_manager` with the given list of `cookies`.
2528
+ *
2529
+ * When the operation is finished, `callback` will be called. You can then call
2530
+ * webkit_cookie_manager_replace_cookies_finish() to get the result of the operation.
2531
+ * @param cookies a #GList of #SoupCookie to be added
2532
+ * @param cancellable a #GCancellable or %NULL to ignore
2533
+ * @param callback (closure user_data): a #GAsyncReadyCallback to call when the request is satisfied
2534
+ */
2535
+ replace_cookies(cookies: Soup.Cookie[], cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void
2536
+ /**
2537
+ * Finish an asynchronous operation started with webkit_cookie_manager_replace_cookies().
2538
+ * @param result a #GAsyncResult
2539
+ * @returns %TRUE if the cookies were added or %FALSE in case of error.
2540
+ */
2541
+ replace_cookies_finish(result: Gio.AsyncResult): boolean
2410
2542
  /**
2411
2543
  * Set the cookie acceptance policy of `cookie_manager` as `policy`.
2412
2544
  *
@@ -5519,8 +5651,7 @@ module Settings {
5519
5651
  */
5520
5652
  javascript_can_open_windows_automatically?: boolean | null
5521
5653
  /**
5522
- * Determines whether a site can load favicons irrespective
5523
- * of the value of #WebKitSettings:auto-load-images.
5654
+ * Unsupported setting. This property does nothing.
5524
5655
  */
5525
5656
  load_icons_ignoring_image_load_setting?: boolean | null
5526
5657
  /**
@@ -5876,8 +6007,7 @@ interface Settings {
5876
6007
  */
5877
6008
  javascript_can_open_windows_automatically: boolean
5878
6009
  /**
5879
- * Determines whether a site can load favicons irrespective
5880
- * of the value of #WebKitSettings:auto-load-images.
6010
+ * Unsupported setting. This property does nothing.
5881
6011
  */
5882
6012
  load_icons_ignoring_image_load_setting: boolean
5883
6013
  /**
@@ -6146,6 +6276,12 @@ interface Settings {
6146
6276
  * @returns The default font family used to display content marked with fantasy font.
6147
6277
  */
6148
6278
  get_fantasy_font_family(): string | null
6279
+ /**
6280
+ * Gets whether a feature is enabled.
6281
+ * @param feature the feature to toggle.
6282
+ * @returns Whether the feature is enabled.
6283
+ */
6284
+ get_feature_enabled(feature: Feature): boolean
6149
6285
  /**
6150
6286
  * Get the #WebKitSettings:hardware-acceleration-policy property.
6151
6287
  * @returns a #WebKitHardwareAccelerationPolicy
@@ -6162,8 +6298,8 @@ interface Settings {
6162
6298
  */
6163
6299
  get_javascript_can_open_windows_automatically(): boolean
6164
6300
  /**
6165
- * Get the #WebKitSettings:load-icons-ignoring-image-load-setting property.
6166
- * @returns %TRUE If site icon can be loaded irrespective of image loading preference or %FALSE otherwise.
6301
+ * Setting no longer supported. This function returns %FALSE.
6302
+ * @returns %FALSE
6167
6303
  */
6168
6304
  get_load_icons_ignoring_image_load_setting(): boolean
6169
6305
  /**
@@ -6423,6 +6559,17 @@ interface Settings {
6423
6559
  * @param fantasy_font_family the new default fantasy font family
6424
6560
  */
6425
6561
  set_fantasy_font_family(fantasy_font_family: string | null): void
6562
+ /**
6563
+ * Enables or disables a feature.
6564
+ *
6565
+ * The current status of the feature can be determined with
6566
+ * [id`webkit_settings_get_feature_enabled]`. To reset a feature to its
6567
+ * initial status, pass the value returned by
6568
+ * [id`webkit_feature_get_default_value]` as the `enabled` parameter.
6569
+ * @param feature the feature to toggle.
6570
+ * @param enabled whether the feature will be enabled.
6571
+ */
6572
+ set_feature_enabled(feature: Feature, enabled: boolean): void
6426
6573
  /**
6427
6574
  * Set the #WebKitSettings:hardware-acceleration-policy property.
6428
6575
  * @param policy a #WebKitHardwareAccelerationPolicy
@@ -6439,7 +6586,7 @@ interface Settings {
6439
6586
  */
6440
6587
  set_javascript_can_open_windows_automatically(enabled: boolean): void
6441
6588
  /**
6442
- * Set the #WebKitSettings:load-icons-ignoring-image-load-setting property.
6589
+ * Setting no longer supported. This function does nothing.
6443
6590
  * @param enabled Value to be set
6444
6591
  */
6445
6592
  set_load_icons_ignoring_image_load_setting(enabled: boolean): void
@@ -6748,6 +6895,40 @@ class Settings extends GObject.Object {
6748
6895
  * @returns the equivalent font size in points.
6749
6896
  */
6750
6897
  static font_size_to_points(pixels: number): number
6898
+ /**
6899
+ * Gets the list of all available WebKit features.
6900
+ *
6901
+ * Features can be toggled with [method`Settings`.set_feature_enabled],
6902
+ * and their current state determined with
6903
+ * [method`Settings`.get_feature_enabled].
6904
+ *
6905
+ * Note that most applications should use
6906
+ * [func`Settings`.get_development_features] and
6907
+ * [func`Settings`.get_experimental_features] instead.
6908
+ * @returns List of all features.
6909
+ */
6910
+ static get_all_features(): FeatureList
6911
+ /**
6912
+ * Gets the list of available development WebKit features.
6913
+ *
6914
+ * The returned features are a subset of those returned by
6915
+ * [func`Settings`.get_all_features], and includes those which
6916
+ * web and WebKit developers might find useful, but in general should
6917
+ * *not* be exposed to end users; see [enum`FeatureStatus]` for
6918
+ * more details.
6919
+ * @returns List of development features.
6920
+ */
6921
+ static get_development_features(): FeatureList
6922
+ /**
6923
+ * Gets the list of available experimental WebKit features.
6924
+ *
6925
+ * The returned features are a subset of those returned by
6926
+ * [func`Settings`.get_all_features], and includes those which
6927
+ * certain applications may want to expose to end users; see
6928
+ * [enum`FeatureStatus]` for more details.
6929
+ * @returns List of experimental features.
6930
+ */
6931
+ static get_experimental_features(): FeatureList
6751
6932
  }
6752
6933
 
6753
6934
  module URIRequest {
@@ -7470,8 +7651,8 @@ interface UserContentManager {
7470
7651
  *
7471
7652
  * The registered handler can be unregistered by using
7472
7653
  * webkit_user_content_manager_unregister_script_message_handler().
7473
- * @param name Name of the script message channel `world_name` (nullable): the name of a #WebKitScriptWorld
7474
- * @param world_name
7654
+ * @param name Name of the script message channel
7655
+ * @param world_name the name of a #WebKitScriptWorld
7475
7656
  * @returns %TRUE if message handler was registered successfully, or %FALSE otherwise.
7476
7657
  */
7477
7658
  register_script_message_handler(name: string | null, world_name: string | null): boolean
@@ -10489,6 +10670,20 @@ module WebsiteDataManager {
10489
10670
  * parameters to configure data directories will be ignored.
10490
10671
  */
10491
10672
  is_ephemeral?: boolean | null
10673
+ /**
10674
+ * The percentage of volume space that can be used for data storage for every domain.
10675
+ * If the maximum storage is reached the storage request will fail with a QuotaExceededError exception.
10676
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10677
+ * means WebKit will use the default quota (1 GiB).
10678
+ */
10679
+ origin_storage_ratio?: number | null
10680
+ /**
10681
+ * The percentage of volume space that can be used for data storage for all domains.
10682
+ * If the maximum storage is reached the eviction will happen.
10683
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10684
+ * means there's no limit for the total storage.
10685
+ */
10686
+ total_storage_ratio?: number | null
10492
10687
  }
10493
10688
 
10494
10689
  }
@@ -10512,6 +10707,20 @@ interface WebsiteDataManager {
10512
10707
  * parameters to configure data directories will be ignored.
10513
10708
  */
10514
10709
  readonly is_ephemeral: boolean
10710
+ /**
10711
+ * The percentage of volume space that can be used for data storage for every domain.
10712
+ * If the maximum storage is reached the storage request will fail with a QuotaExceededError exception.
10713
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10714
+ * means WebKit will use the default quota (1 GiB).
10715
+ */
10716
+ readonly origin_storage_ratio: number
10717
+ /**
10718
+ * The percentage of volume space that can be used for data storage for all domains.
10719
+ * If the maximum storage is reached the eviction will happen.
10720
+ * A value of 0.0 means that data storage is not allowed. A value of -1.0, which is the default,
10721
+ * means there's no limit for the total storage.
10722
+ */
10723
+ readonly total_storage_ratio: number
10515
10724
 
10516
10725
  // Owm methods of WebKit-6.0.WebKit.WebsiteDataManager
10517
10726
 
@@ -10633,6 +10842,12 @@ interface WebsiteDataManager {
10633
10842
  connect(sigName: "notify::is-ephemeral", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10634
10843
  connect_after(sigName: "notify::is-ephemeral", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10635
10844
  emit(sigName: "notify::is-ephemeral", ...args: any[]): void
10845
+ connect(sigName: "notify::origin-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10846
+ connect_after(sigName: "notify::origin-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10847
+ emit(sigName: "notify::origin-storage-ratio", ...args: any[]): void
10848
+ connect(sigName: "notify::total-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10849
+ connect_after(sigName: "notify::total-storage-ratio", callback: (($obj: WebsiteDataManager, pspec: GObject.ParamSpec) => void)): number
10850
+ emit(sigName: "notify::total-storage-ratio", ...args: any[]): void
10636
10851
  connect(sigName: string, callback: (...args: any[]) => void): number
10637
10852
  connect_after(sigName: string, callback: (...args: any[]) => void): number
10638
10853
  emit(sigName: string, ...args: any[]): void
@@ -10645,18 +10860,11 @@ interface WebsiteDataManager {
10645
10860
  * You can use WebKitWebsiteDataManager to configure the local directories
10646
10861
  * where website data will be stored. Use #WebKitWebsiteDataManager:base-data-directory
10647
10862
  * and #WebKitWebsiteDataManager:base-cache-directory set a common base directory for all
10648
- * website data and caches. The newly created WebKitWebsiteDataManager must be passed as
10649
- * a construct property to a #WebKitWebContext; you can use webkit_web_context_new_with_website_data_manager()
10650
- * to create a new #WebKitWebContext with a WebKitWebsiteDataManager.
10651
- * If you don't want to set any specific configuration, you don't need to create
10652
- * a WebKitWebsiteDataManager: the #WebKitWebContext will create a WebKitWebsiteDataManager
10653
- * with the default configuration. To get the WebKitWebsiteDataManager of a #WebKitWebContext,
10654
- * you can use webkit_web_context_get_website_data_manager().
10863
+ * website data and caches.
10655
10864
  *
10656
- * A WebKitWebsiteDataManager can also be ephemeral, in which case all the directory configuration
10865
+ * A WebKitWebsiteDataManager can be ephemeral, in which case all the directory configuration
10657
10866
  * is not needed because website data will never persist. You can create an ephemeral WebKitWebsiteDataManager
10658
- * with webkit_website_data_manager_new_ephemeral() and pass the ephemeral WebKitWebsiteDataManager to
10659
- * a #WebKitWebContext, or simply use webkit_web_context_new_ephemeral().
10867
+ * with webkit_website_data_manager_new_ephemeral().
10660
10868
  *
10661
10869
  * WebKitWebsiteDataManager can also be used to fetch website data, remove data
10662
10870
  * stored by particular websites, or clear data for all websites modified since a given
@@ -11114,6 +11322,20 @@ abstract class BackForwardListItemClass {
11114
11322
  static name: string
11115
11323
  }
11116
11324
 
11325
+ interface ClipboardPermissionRequestClass {
11326
+
11327
+ // Own fields of WebKit-6.0.WebKit.ClipboardPermissionRequestClass
11328
+
11329
+ parent_class: GObject.ObjectClass
11330
+ }
11331
+
11332
+ abstract class ClipboardPermissionRequestClass {
11333
+
11334
+ // Own properties of WebKit-6.0.WebKit.ClipboardPermissionRequestClass
11335
+
11336
+ static name: string
11337
+ }
11338
+
11117
11339
  interface ColorChooserRequestClass {
11118
11340
 
11119
11341
  // Own fields of WebKit-6.0.WebKit.ColorChooserRequestClass
@@ -11318,6 +11540,182 @@ abstract class FaviconDatabaseClass {
11318
11540
  static name: string
11319
11541
  }
11320
11542
 
11543
+ interface Feature {
11544
+
11545
+ // Owm methods of WebKit-6.0.WebKit.Feature
11546
+
11547
+ /**
11548
+ * Gets the category of the feature.
11549
+ *
11550
+ * Applications which include user interface to toggle features may want
11551
+ * to use the category to group related features together.
11552
+ * @returns Feature category.
11553
+ */
11554
+ get_category(): string | null
11555
+ /**
11556
+ * Gets whether the feature is enabled by default.
11557
+ *
11558
+ * The default value may be used by applications which include user interface
11559
+ * to toggle features to restore its settings to their defaults. Note that
11560
+ * whether a feature is actually enabled must be checked with
11561
+ * [method`Settings`.get_feature_enabled].
11562
+ * @returns Whether the feature is enabled by default.
11563
+ */
11564
+ get_default_value(): boolean
11565
+ /**
11566
+ * Gets a description for the `feature`.
11567
+ *
11568
+ * The detailed description should be considered an additional clarification
11569
+ * on the purpose of the feature, to be used as complementary aid to be
11570
+ * displayed along the feature name returned by [method`Feature`.get_name].
11571
+ * The returned string is suitable to be displayed to end users, but it
11572
+ * should not be relied upon being localized.
11573
+ *
11574
+ * Note that some *features may not* have a detailed description, and `NULL`
11575
+ * is returned in this case.
11576
+ * @returns Feature description.
11577
+ */
11578
+ get_details(): string | null
11579
+ /**
11580
+ * Gets a string that uniquely identifies the `feature`.
11581
+ * @returns The identifier string for the feature.
11582
+ */
11583
+ get_identifier(): string | null
11584
+ /**
11585
+ * Gets a short name for the `feature`.
11586
+ *
11587
+ * The returned string is suitable to be displayed to end users, but it
11588
+ * should not be relied upon being localized.
11589
+ *
11590
+ * Note that some *features may not* have a short name, and `NULL`
11591
+ * is returned in this case.
11592
+ * @returns Short feature name.
11593
+ */
11594
+ get_name(): string | null
11595
+ /**
11596
+ * Gets the status of the feature.
11597
+ * @returns Feature status.
11598
+ */
11599
+ get_status(): FeatureStatus
11600
+ /**
11601
+ * Atomically acquires a reference on the given `feature`.
11602
+ *
11603
+ * This function is MT-safe and may be called from any thread.
11604
+ * @returns The same @feature with an additional reference.
11605
+ */
11606
+ ref(): Feature
11607
+ /**
11608
+ * Atomically releases a reference on the given `feature`.
11609
+ *
11610
+ * If the reference was the last, the resources associated to the
11611
+ * `feature` are freed. This function is MT-safe and may be called from
11612
+ * any thread.
11613
+ */
11614
+ unref(): void
11615
+ }
11616
+
11617
+ /**
11618
+ * Describes a web engine feature that may be toggled at runtime.
11619
+ *
11620
+ * The WebKit web engine includes a set of features which may be toggled
11621
+ * programmatically, each one represented by a #WebKitFeature that provides
11622
+ * information about it:
11623
+ *
11624
+ * - A unique “identifier”: [method`Feature`.get_identifier].
11625
+ * - A “default value”, which indicates whether the option is enabled
11626
+ * automatically: [method`Feature`.get_default_value].
11627
+ * - Its “status”, which determines whether it should be considered
11628
+ * user-settable and its development stage (see [enum`FeatureStatus]`
11629
+ * for details): [method`Feature`.get_status].
11630
+ * - A category, which may be used to group features together:
11631
+ * [method`Feature`.get_category].
11632
+ * - An optional short “name” which can be presented to an user:
11633
+ * [method`Feature`.get_name].
11634
+ * - An optional longer “detailed” description:
11635
+ * [method`Feature`.get_details].
11636
+ *
11637
+ * The lists of available features can be obtained with
11638
+ * [func`Settings`.get_all_features], [func`Settings`.get_experimental_features],
11639
+ * and [func`Settings`.get_development_features]). As a rule of thumb,
11640
+ * applications which may want to allow users (i.e. web developers) to test
11641
+ * WebKit features should use the list of experimental features. Additionally,
11642
+ * applications might want to expose development features *when targeting
11643
+ * technically inclined users* for early testing of in-development features
11644
+ * (i.e. in “technology preview” or “canary” builds).
11645
+ *
11646
+ * Applications **must not** expose the list of all features to end users
11647
+ * because they often lack descriptions and control parts of the web engine
11648
+ * which are either intended to be used during development of WebKit itself,
11649
+ * or in specific scenarios to tweak how WebKit integrates with the
11650
+ * application.
11651
+ * @record
11652
+ */
11653
+ class Feature {
11654
+
11655
+ // Own properties of WebKit-6.0.WebKit.Feature
11656
+
11657
+ static name: string
11658
+ }
11659
+
11660
+ interface FeatureList {
11661
+
11662
+ // Owm methods of WebKit-6.0.WebKit.FeatureList
11663
+
11664
+ /**
11665
+ * Gets a feature given its index.
11666
+ * @param index index of the feature
11667
+ * @returns The feature at @index.
11668
+ */
11669
+ get(index: number): Feature
11670
+ /**
11671
+ * Gets the number of elements in the feature list.
11672
+ * @returns number of elements. Since 2.42
11673
+ */
11674
+ get_length(): number
11675
+ /**
11676
+ * Atomically acquires a reference on the given `feature_list`.
11677
+ *
11678
+ * This function is MT-safe and may be called from any thread.
11679
+ * @returns The same @feature_list with an additional reference.
11680
+ */
11681
+ ref(): FeatureList
11682
+ /**
11683
+ * Atomically releases a reference on the given `feature_list`.
11684
+ *
11685
+ * If the reference was the last, the resources associated to the
11686
+ * `feature_list` are freed. This function is MT-safe and may be called
11687
+ * from any thread.
11688
+ */
11689
+ unref(): void
11690
+ }
11691
+
11692
+ /**
11693
+ * Contains a set of toggle-able web engine features.
11694
+ *
11695
+ * The list supports passing around a set of [struct`Feature]` objects and
11696
+ * iterating over them:
11697
+ *
11698
+ * ```c
11699
+ * g_autoptr(WebKitFeatureList) list = webkit_settings_get_experimental_features();
11700
+ * for (gsize i = 0; i < webkit_feature_list_get_length(list): i++) {
11701
+ * WebKitFeature *feature = webkit_feature_list_get(list, i);
11702
+ * // Do something with "feature".
11703
+ * }
11704
+ * ```
11705
+ *
11706
+ * Lists of features can be obtained with
11707
+ * [func`Settings`.get_experimental_features],
11708
+ * [func`Settings`.get_development_features], and
11709
+ * [func`Settings`.get_all_features].
11710
+ * @record
11711
+ */
11712
+ class FeatureList {
11713
+
11714
+ // Own properties of WebKit-6.0.WebKit.FeatureList
11715
+
11716
+ static name: string
11717
+ }
11718
+
11321
11719
  interface FileChooserRequestClass {
11322
11720
 
11323
11721
  // Own fields of WebKit-6.0.WebKit.FileChooserRequestClass