Add cancellation examples

v3/examples/cancel-async/GreetService.go

@@ -0,0 +1,19 @@
+package main
+
+import (
+	"context"
+	"time"
+)
+
+type Service struct {
+}
+
+// A long running operation of specified duration.
+func (*Service) LongRunning(ctx context.Context, milliseconds int) error {
+	select {
+	case <-time.After(time.Duration(milliseconds) * time.Millisecond):
+		return nil
+	case <-ctx.Done():
+		return ctx.Err()
+	}
+}

v3/examples/cancel-async/README.md

@@ -0,0 +1,5 @@
+# Binding Call Cancelling Example
+
+This example demonstrates how to cancel binding calls in async/await style.
+
+To regenerate bindings, run `wails3 generate bindings -clean -b -d assets/bindings` in this directory.

v3/examples/cancel-async/assets/bindings/github.com/wailsapp/wails/v3/examples/cancel-async/index.js

@@ -0,0 +1,8 @@
+// @ts-check
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+import * as Service from "./service.js";
+export {
+    Service
+};

v3/examples/cancel-async/assets/bindings/github.com/wailsapp/wails/v3/examples/cancel-async/service.js

@@ -0,0 +1,16 @@
+// @ts-check
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import {Call as $Call, CancellablePromise as $CancellablePromise, Create as $Create} from "/wails/runtime.js";
+
+/**
+ * A long running operation of specified duration.
+ * @param {number} milliseconds
+ * @returns {$CancellablePromise<void>}
+ */
+export function LongRunning(milliseconds) {
+    return $Call.ByID(298191698, milliseconds);
+}

v3/examples/cancel-async/main.go

@@ -0,0 +1,37 @@
+package main
+
+import (
+	"embed"
+	"log"
+
+	"github.com/wailsapp/wails/v3/pkg/application"
+)
+
+//go:embed assets/*
+var assets embed.FS
+
+func main() {
+	app := application.New(application.Options{
+		Services: []application.Service{
+			application.NewService(&Service{}),
+		},
+		Assets: application.AssetOptions{
+			Handler: application.BundledAssetFileServer(assets),
+		},
+		Mac: application.MacOptions{
+			ApplicationShouldTerminateAfterLastWindowClosed: true,
+		},
+	})
+
+	app.NewWebviewWindowWithOptions(application.WebviewWindowOptions{
+		URL:             "/",
+		DevToolsEnabled: true,
+	})
+
+	err := app.Run()
+
+	if err != nil {
+		log.Fatal(err)
+	}
+
+}

v3/examples/cancel-chaining/GreetService.go

@@ -0,0 +1,19 @@
+package main
+
+import (
+	"context"
+	"time"
+)
+
+type Service struct {
+}
+
+// A long running operation of specified duration.
+func (*Service) LongRunning(ctx context.Context, milliseconds int) error {
+	select {
+	case <-time.After(time.Duration(milliseconds) * time.Millisecond):
+		return nil
+	case <-ctx.Done():
+		return ctx.Err()
+	}
+}

v3/examples/cancel-chaining/README.md

@@ -0,0 +1,5 @@
+# Binding Call Cancelling Example
+
+This example demonstrates how to cancel binding calls in promise chaining style.
+
+To regenerate bindings, run `wails3 generate bindings -clean -b -d assets/bindings` in this directory.

v3/examples/cancel-chaining/assets/bindings/github.com/wailsapp/wails/v3/examples/cancel-chaining/index.js

@@ -0,0 +1,8 @@
+// @ts-check
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+import * as Service from "./service.js";
+export {
+    Service
+};

v3/examples/cancel-chaining/assets/bindings/github.com/wailsapp/wails/v3/examples/cancel-chaining/service.js

@@ -0,0 +1,16 @@
+// @ts-check
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import {Call as $Call, CancellablePromise as $CancellablePromise, Create as $Create} from "/wails/runtime.js";
+
+/**
+ * A long running operation of specified duration.
+ * @param {number} milliseconds
+ * @returns {$CancellablePromise<void>}
+ */
+export function LongRunning(milliseconds) {
+    return $Call.ByID(298191698, milliseconds);
+}

v3/examples/cancel-chaining/main.go

@@ -0,0 +1,37 @@
+package main
+
+import (
+	"embed"
+	"log"
+
+	"github.com/wailsapp/wails/v3/pkg/application"
+)
+
+//go:embed assets/*
+var assets embed.FS
+
+func main() {
+	app := application.New(application.Options{
+		Services: []application.Service{
+			application.NewService(&Service{}),
+		},
+		Assets: application.AssetOptions{
+			Handler: application.BundledAssetFileServer(assets),
+		},
+		Mac: application.MacOptions{
+			ApplicationShouldTerminateAfterLastWindowClosed: true,
+		},
+	})
+
+	app.NewWebviewWindowWithOptions(application.WebviewWindowOptions{
+		URL:             "/",
+		DevToolsEnabled: true,
+	})
+
+	err := app.Run()
+
+	if err != nil {
+		log.Fatal(err)
+	}
+
+}