go/pkg/webview/angular.go
Claude d570c87efc
chore: fmt.Errorf(static) → errors.New
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 15:38:38 +00:00

627 lines
15 KiB
Go

package webview
import (
"context"
"errors"
"fmt"
"time"
)
// AngularHelper provides Angular-specific testing utilities.
type AngularHelper struct {
wv *Webview
timeout time.Duration
}
// NewAngularHelper creates a new Angular helper for the webview.
func NewAngularHelper(wv *Webview) *AngularHelper {
return &AngularHelper{
wv: wv,
timeout: 30 * time.Second,
}
}
// SetTimeout sets the default timeout for Angular operations.
func (ah *AngularHelper) SetTimeout(d time.Duration) {
ah.timeout = d
}
// WaitForAngular waits for Angular to finish all pending operations.
// This includes HTTP requests, timers, and change detection.
func (ah *AngularHelper) WaitForAngular() error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
return ah.waitForAngular(ctx)
}
// waitForAngular implements the Angular wait logic.
func (ah *AngularHelper) waitForAngular(ctx context.Context) error {
// Check if Angular is present
isAngular, err := ah.isAngularApp(ctx)
if err != nil {
return err
}
if !isAngular {
return errors.New("not an Angular application")
}
// Wait for Zone.js stability
return ah.waitForZoneStability(ctx)
}
// isAngularApp checks if the current page is an Angular application.
func (ah *AngularHelper) isAngularApp(ctx context.Context) (bool, error) {
script := `
(function() {
// Check for Angular 2+
if (window.getAllAngularRootElements && window.getAllAngularRootElements().length > 0) {
return true;
}
// Check for Angular CLI generated apps
if (document.querySelector('[ng-version]')) {
return true;
}
// Check for Angular elements
if (window.ng && typeof window.ng.probe === 'function') {
return true;
}
// Check for AngularJS (1.x)
if (window.angular && window.angular.element) {
return true;
}
return false;
})()
`
result, err := ah.wv.evaluate(ctx, script)
if err != nil {
return false, err
}
isAngular, ok := result.(bool)
if !ok {
return false, nil
}
return isAngular, nil
}
// waitForZoneStability waits for Zone.js to become stable.
func (ah *AngularHelper) waitForZoneStability(ctx context.Context) error {
script := `
new Promise((resolve, reject) => {
// Get the root elements
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
if (roots.length === 0) {
// Try to find root element directly
const appRoot = document.querySelector('[ng-version]');
if (appRoot) {
roots.push(appRoot);
}
}
if (roots.length === 0) {
resolve(true); // No Angular roots found, nothing to wait for
return;
}
// Get the Zone from any root element
let zone = null;
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
zone = injector.get(window.ng.coreTokens.NgZone || 'NgZone');
if (zone) break;
} catch (e) {
// Continue to next root
}
}
if (!zone) {
// Fallback: check window.Zone
if (window.Zone && window.Zone.current && window.Zone.current._inner) {
const isStable = !window.Zone.current._inner._hasPendingMicrotasks &&
!window.Zone.current._inner._hasPendingMacrotasks;
if (isStable) {
resolve(true);
} else {
// Poll for stability
let attempts = 0;
const poll = setInterval(() => {
attempts++;
const stable = !window.Zone.current._inner._hasPendingMicrotasks &&
!window.Zone.current._inner._hasPendingMacrotasks;
if (stable || attempts > 100) {
clearInterval(poll);
resolve(stable);
}
}, 50);
}
} else {
resolve(true);
}
return;
}
// Use Angular's zone stability
if (zone.isStable) {
resolve(true);
return;
}
// Wait for stability
const sub = zone.onStable.subscribe(() => {
sub.unsubscribe();
resolve(true);
});
// Timeout fallback
setTimeout(() => {
sub.unsubscribe();
resolve(zone.isStable);
}, 5000);
})
`
ticker := time.NewTicker(100 * time.Millisecond)
defer ticker.Stop()
// First evaluate the promise
_, err := ah.wv.evaluate(ctx, script)
if err != nil {
// If the script fails, fall back to simple polling
return ah.pollForStability(ctx)
}
return nil
}
// pollForStability polls for Angular stability as a fallback.
func (ah *AngularHelper) pollForStability(ctx context.Context) error {
script := `
(function() {
if (window.Zone && window.Zone.current) {
const inner = window.Zone.current._inner || window.Zone.current;
return !inner._hasPendingMicrotasks && !inner._hasPendingMacrotasks;
}
return true;
})()
`
ticker := time.NewTicker(50 * time.Millisecond)
defer ticker.Stop()
for {
select {
case <-ctx.Done():
return ctx.Err()
case <-ticker.C:
result, err := ah.wv.evaluate(ctx, script)
if err != nil {
continue
}
if stable, ok := result.(bool); ok && stable {
return nil
}
}
}
}
// NavigateByRouter navigates using Angular Router.
func (ah *AngularHelper) NavigateByRouter(path string) error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
if (roots.length === 0) {
throw new Error('No Angular root elements found');
}
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
const router = injector.get(window.ng.coreTokens.Router || 'Router');
if (router) {
router.navigateByUrl(%q);
return true;
}
} catch (e) {
continue;
}
}
throw new Error('Could not find Angular Router');
})()
`, path)
_, err := ah.wv.evaluate(ctx, script)
if err != nil {
return fmt.Errorf("failed to navigate: %w", err)
}
// Wait for navigation to complete
return ah.waitForZoneStability(ctx)
}
// GetRouterState returns the current Angular router state.
func (ah *AngularHelper) GetRouterState() (*AngularRouterState, error) {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := `
(function() {
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
const router = injector.get(window.ng.coreTokens.Router || 'Router');
if (router) {
return {
url: router.url,
fragment: router.routerState.root.fragment,
params: router.routerState.root.params,
queryParams: router.routerState.root.queryParams
};
}
} catch (e) {
continue;
}
}
return null;
})()
`
result, err := ah.wv.evaluate(ctx, script)
if err != nil {
return nil, err
}
if result == nil {
return nil, errors.New("could not get router state")
}
// Parse result
resultMap, ok := result.(map[string]any)
if !ok {
return nil, errors.New("invalid router state format")
}
state := &AngularRouterState{
URL: getString(resultMap, "url"),
}
if fragment, ok := resultMap["fragment"].(string); ok {
state.Fragment = fragment
}
if params, ok := resultMap["params"].(map[string]any); ok {
state.Params = make(map[string]string)
for k, v := range params {
if s, ok := v.(string); ok {
state.Params[k] = s
}
}
}
if queryParams, ok := resultMap["queryParams"].(map[string]any); ok {
state.QueryParams = make(map[string]string)
for k, v := range queryParams {
if s, ok := v.(string); ok {
state.QueryParams[k] = s
}
}
}
return state, nil
}
// AngularRouterState represents Angular router state.
type AngularRouterState struct {
URL string `json:"url"`
Fragment string `json:"fragment,omitempty"`
Params map[string]string `json:"params,omitempty"`
QueryParams map[string]string `json:"queryParams,omitempty"`
}
// GetComponentProperty gets a property from an Angular component.
func (ah *AngularHelper) GetComponentProperty(selector, propertyName string) (any, error) {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) {
throw new Error('Element not found: %s');
}
const component = window.ng.probe(element).componentInstance;
if (!component) {
throw new Error('No Angular component found on element');
}
return component[%q];
})()
`, selector, selector, propertyName)
return ah.wv.evaluate(ctx, script)
}
// SetComponentProperty sets a property on an Angular component.
func (ah *AngularHelper) SetComponentProperty(selector, propertyName string, value any) error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) {
throw new Error('Element not found: %s');
}
const component = window.ng.probe(element).componentInstance;
if (!component) {
throw new Error('No Angular component found on element');
}
component[%q] = %v;
// Trigger change detection
const injector = window.ng.probe(element).injector;
const appRef = injector.get(window.ng.coreTokens.ApplicationRef || 'ApplicationRef');
if (appRef) {
appRef.tick();
}
return true;
})()
`, selector, selector, propertyName, formatJSValue(value))
_, err := ah.wv.evaluate(ctx, script)
return err
}
// CallComponentMethod calls a method on an Angular component.
func (ah *AngularHelper) CallComponentMethod(selector, methodName string, args ...any) (any, error) {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
argsStr := ""
for i, arg := range args {
if i > 0 {
argsStr += ", "
}
argsStr += formatJSValue(arg)
}
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) {
throw new Error('Element not found: %s');
}
const component = window.ng.probe(element).componentInstance;
if (!component) {
throw new Error('No Angular component found on element');
}
if (typeof component[%q] !== 'function') {
throw new Error('Method not found: %s');
}
const result = component[%q](%s);
// Trigger change detection
const injector = window.ng.probe(element).injector;
const appRef = injector.get(window.ng.coreTokens.ApplicationRef || 'ApplicationRef');
if (appRef) {
appRef.tick();
}
return result;
})()
`, selector, selector, methodName, methodName, methodName, argsStr)
return ah.wv.evaluate(ctx, script)
}
// TriggerChangeDetection manually triggers Angular change detection.
func (ah *AngularHelper) TriggerChangeDetection() error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := `
(function() {
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
const appRef = injector.get(window.ng.coreTokens.ApplicationRef || 'ApplicationRef');
if (appRef) {
appRef.tick();
return true;
}
} catch (e) {
continue;
}
}
return false;
})()
`
_, err := ah.wv.evaluate(ctx, script)
return err
}
// GetService gets an Angular service by token name.
func (ah *AngularHelper) GetService(serviceName string) (any, error) {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
const service = injector.get(%q);
if (service) {
// Return a serializable representation
return JSON.parse(JSON.stringify(service));
}
} catch (e) {
continue;
}
}
return null;
})()
`, serviceName)
return ah.wv.evaluate(ctx, script)
}
// WaitForComponent waits for an Angular component to be present.
func (ah *AngularHelper) WaitForComponent(selector string) error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) return false;
try {
const component = window.ng.probe(element).componentInstance;
return !!component;
} catch (e) {
return false;
}
})()
`, selector)
ticker := time.NewTicker(100 * time.Millisecond)
defer ticker.Stop()
for {
select {
case <-ctx.Done():
return ctx.Err()
case <-ticker.C:
result, err := ah.wv.evaluate(ctx, script)
if err != nil {
continue
}
if found, ok := result.(bool); ok && found {
return nil
}
}
}
}
// DispatchEvent dispatches a custom event on an element.
func (ah *AngularHelper) DispatchEvent(selector, eventName string, detail any) error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
detailStr := "null"
if detail != nil {
detailStr = formatJSValue(detail)
}
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) {
throw new Error('Element not found: %s');
}
const event = new CustomEvent(%q, { bubbles: true, detail: %s });
element.dispatchEvent(event);
return true;
})()
`, selector, selector, eventName, detailStr)
_, err := ah.wv.evaluate(ctx, script)
return err
}
// GetNgModel gets the value of an ngModel-bound input.
func (ah *AngularHelper) GetNgModel(selector string) (any, error) {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) return null;
// Try to get from component
try {
const debug = window.ng.probe(element);
const component = debug.componentInstance;
// Look for common ngModel patterns
if (element.tagName === 'INPUT' || element.tagName === 'SELECT' || element.tagName === 'TEXTAREA') {
return element.value;
}
} catch (e) {}
return element.value || element.textContent;
})()
`, selector)
return ah.wv.evaluate(ctx, script)
}
// SetNgModel sets the value of an ngModel-bound input.
func (ah *AngularHelper) SetNgModel(selector string, value any) error {
ctx, cancel := context.WithTimeout(ah.wv.ctx, ah.timeout)
defer cancel()
script := fmt.Sprintf(`
(function() {
const element = document.querySelector(%q);
if (!element) {
throw new Error('Element not found: %s');
}
element.value = %v;
element.dispatchEvent(new Event('input', { bubbles: true }));
element.dispatchEvent(new Event('change', { bubbles: true }));
// Trigger change detection
const roots = window.getAllAngularRootElements ? window.getAllAngularRootElements() : [];
for (const root of roots) {
try {
const injector = window.ng.probe(root).injector;
const appRef = injector.get(window.ng.coreTokens.ApplicationRef || 'ApplicationRef');
if (appRef) {
appRef.tick();
break;
}
} catch (e) {}
}
return true;
})()
`, selector, selector, formatJSValue(value))
_, err := ah.wv.evaluate(ctx, script)
return err
}
// Helper functions
func getString(m map[string]any, key string) string {
if v, ok := m[key].(string); ok {
return v
}
return ""
}
func formatJSValue(v any) string {
switch val := v.(type) {
case string:
return fmt.Sprintf("%q", val)
case bool:
if val {
return "true"
}
return "false"
case nil:
return "null"
default:
return fmt.Sprintf("%v", val)
}
}