Files
Febe/tests/Febe.Tests/Desktop/Support/FakeDesktopShell.cs
T
Alby96andClaude Opus 5.5 c49df4ca7b Browser mai bianco né muto: pagina iniziale, finestra che resta, fotogrammi che ripartono (#52)
Il browser di Febe a volte era bianco o non mostrava nulla. Le cause erano
diverse e si correggono insieme.

- Pagina iniziale. Se il browser è a riposo su about:blank e Alberto lo apre
  («Usa il browser», «Apri il browser»), Febe lo porta sulla home del sito
  quando è collegato, altrimenti sulla pagina di accesso. È un'azione di
  Alberto, sotto il suo permesso di guida, non del motore: Febe aspetta che
  la sessione finisca e prende il turno della pagina.
  Il nuovo pulsante «Pagina iniziale» sta nella barra della finestra di
  Windows e nella vista remota. Su about:blank la barra dice «Il browser è a
  riposo su una pagina vuota». «Indietro» non torna più sulla pagina di
  riposo.
- Disconnessione. «Apri il browser» nella striscia rossa apre la pagina di
  accesso. Con --accesso-di-prova il primo controllo all'avvio non segnala
  più una disconnessione finta.
- Windows: la finestra resta.
  - Lasciare una pagina di Febe non nasconde più la finestra «Browser di
    Febe» e non la rimette a riposo: finisce solo il permesso tenuto dalla
    pagina (cancel con pageLeft, IConnectionService.ReleaseAsync).
  - Sullo schermo la finestra ha il suo pulsante nella barra delle
    applicazioni, così ridurla a icona non la fa sparire. Dopo 2 minuti
    ridotta a icona torna fuori vista (S2).
  - Se lo schermo è troppo piccolo, la finestra si restringe all'area di
    lavoro e la pagina si rimpicciolisce con ZoomFactor, con le stesse misure
    CSS.
  - I bordi della pagina si riapplicano, con NotifyParentWindowPositionChanged,
    quando la finestra si mostra, si sposta o riparte il processo GPU.
  - Una pagina che non risponde mentre Alberto guida resta com'è.
  - IBrowserWindow.ShowAsync lascia il posto a
    IConnectionService.ShowBrowserAsync.
- Docker: fotogrammi che ripartono. La vista remota ha un watchdog. Riavvia
  i fotogrammi dopo una pagina nuova caricata senza fotogrammi e dopo circa
  2 s di silenzio. L'attesa raddoppia fino a 30 s finché la pagina resta
  ferma. Se il riavvio non porta nulla, la vista riceve un'immagine ferma
  (Page.captureScreenshot, già fra i comandi ammessi).
  RemoteViewSession ha ora un registro vero: avvii, riavvii e silenzi vanno
  a livello Info, categoria «vista», senza indirizzi.
  Se dopo 8 s non arriva nessuna immagine, l'interfaccia mostra «Nessuna
  immagine dal browser» con «Riprova».

Nessun comando CDP nuovo e nessuna dipendenza nuova. Aggiornati PROTOCOLLO.md
e la guida (Primo collegamento, Attività e arresti, Installazione Windows,
Problemi comuni).

Prove nuove:
- ScreencastWatchdogTests, RemoteViewFramesTests (Chromium vero, solo CI
  Linux)
- Home e Indietro in RemoteViewStartTests
- RemoteViewSocketTests
- ConnectionApiTests
- BrowserStartPageTests
- BrowserWindowDecisionTests e BrowserWindowTests (WebView2 vero)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 12:51:12 +01:00

324 lines
10 KiB
C#

using System.Collections.Concurrent;
using System.Text.Json;
using System.Text.Json.Nodes;
using Febe.App;
using Febe.Browser.Cdp;
using Febe.Browser.Hosting;
using Febe.Core.Abstractions;
using Febe.Desktop.Core;
using Febe.Web.Native;
namespace Febe.Tests.Desktop.Support;
/// <summary>The Windows-only part of the desktop, faked: what the platform asks of it is recorded.</summary>
internal sealed class FakeDesktopShell : IDesktopShell
{
public FakeNativeShell NativeShell { get; } = new();
public INativeShell Native => NativeShell;
/// <summary>The WebView2 runtime this «Windows» has (null: missing).</summary>
public string? RuntimeVersion { get; set; } = "141.0.3537.71";
/// <summary>Where «Edge» is (null: not installed).</summary>
public string? EdgePath { get; set; }
/// <summary>The browsers created, with the settings the platform gave them.</summary>
public ConcurrentQueue<(WebView2BrowserSettings Settings, FakeBrowser Browser)> Created { get; } = new();
public ConcurrentQueue<string> ProcessWindows { get; } = new();
/// <summary>Called with each browser as it is created, before Febe uses it (to set up the fake page).</summary>
public Action<FakeBrowser>? OnCreated { get; set; }
public string? WebView2Version() => RuntimeVersion;
public IFebeBrowser CreateWebView2Browser(WebView2BrowserSettings settings, FebePlatformContext context)
{
var browser = new FakeBrowser(settings.ProfileDirectory, settings.Width, settings.Height, context);
OnCreated?.Invoke(browser);
Created.Enqueue((settings, browser));
return browser;
}
public string? FindEdge() => EdgePath;
public Task ShowProcessWindowAsync(int processId, CancellationToken ct)
{
ProcessWindows.Enqueue("mostra " + processId);
return Task.CompletedTask;
}
public Task HideProcessWindowAsync(int processId, CancellationToken ct)
{
ProcessWindows.Enqueue("nascondi " + processId);
return Task.CompletedTask;
}
/// <summary>The processes the platform asked to tie to Febe's life (Edge), by id.</summary>
public ConcurrentQueue<int> TiedToFebe { get; } = new();
/// <summary>What «Windows» answers when a process is tied to Febe.</summary>
public bool TieSucceeds { get; set; } = true;
public bool EndWithFebe(System.Diagnostics.Process process)
{
TiedToFebe.Enqueue(process.Id);
return TieSucceeds;
}
}
/// <summary>Folder picker, explorer, default browser, notifications (the Windows alerts) and autostart, faked.</summary>
internal sealed class FakeNativeShell : INativeShell
{
public bool CanPickFolder => true;
public bool CanShowInFolder => true;
public bool CanOpenUrl => true;
public bool CanNotify => true;
public bool SupportsAutostart => true;
public bool Autostart { get; private set; }
public string? FolderToPick { get; set; }
public ConcurrentQueue<string> Shown { get; } = new();
public ConcurrentQueue<Uri> Opened { get; } = new();
public ConcurrentQueue<(string Title, string Message)> Notified { get; } = new();
public Task<string?> PickFolderAsync(string title, string? initialFolder, CancellationToken ct) => Task.FromResult(FolderToPick);
public Task<bool> ShowInFolderAsync(string fullPath, CancellationToken ct)
{
Shown.Enqueue(fullPath);
return Task.FromResult(true);
}
public Task<bool> OpenUrlAsync(Uri address, CancellationToken ct)
{
Opened.Enqueue(address);
return Task.FromResult(true);
}
public Task NotifyAsync(string title, string message, CancellationToken ct)
{
Notified.Enqueue((title, message));
return Task.CompletedTask;
}
public Task<bool> GetAutostartAsync(CancellationToken ct) => Task.FromResult(Autostart);
public Task SetAutostartAsync(bool enabled, CancellationToken ct)
{
Autostart = enabled;
return Task.CompletedTask;
}
}
/// <summary>
/// The window «Browser di Febe», faked: a CDP session that answers like a browser on a blank page, a session cookie
/// that exists once «Alberto» has logged in, and a record of every time the window came to the front or went away.
/// </summary>
internal sealed class FakeBrowser : IFebeBrowser
{
private readonly FebePlatformContext _context;
private IDisposable? _lease;
public FakeBrowser(string profileDirectory, int width, int height, FebePlatformContext context)
{
ProfileDirectory = profileDirectory;
WindowWidth = width;
WindowHeight = height;
_context = context;
}
public FakeCdp FakeCdp { get; } = new();
public ICdpSession Cdp => FakeCdp;
public UserDrivingGate UserDriving { get; } = new();
public bool UserIsDriving => UserDriving.IsDriving;
public bool IsAvailable { get; private set; }
public string? LastError => null;
public string ProfileDirectory { get; }
public int WindowWidth { get; }
public int WindowHeight { get; }
public int Shown { get; private set; }
public int Hidden { get; private set; }
public int EmptiedProfiles { get; private set; }
public bool Disposed { get; private set; }
public Task RunAsync(CancellationToken ct)
{
Directory.CreateDirectory(ProfileDirectory);
IsAvailable = true;
return Task.CompletedTask;
}
public Task<NavigationResult> RestAsync(CancellationToken ct) => FakeCdp.NavigateAsync(CdpPageExtensions.RestUrl, ct);
/// <summary>Like the real window: in front, Alberto is driving.</summary>
public Task ShowToUserAsync(CancellationToken ct)
{
Shown++;
_lease ??= UserDriving.Begin();
_context.Tracker.MarkUsed(_context.Clock.Now);
return Task.CompletedTask;
}
public Task HideFromUserAsync(CancellationToken ct)
{
Hidden++;
_lease?.Dispose();
_lease = null;
return Task.CompletedTask;
}
/// <summary>The next «Scollega» finds a file held by another process (Windows) and cannot delete the profile.</summary>
public bool ProfileLocked { get; set; }
public Task RestartWithEmptyProfileAsync(CancellationToken ct)
{
if (ProfileLocked)
{
throw new IOException("Il file Cookies è in uso da un altro processo.");
}
if (Directory.Exists(ProfileDirectory))
{
Directory.Delete(ProfileDirectory, recursive: true);
}
Directory.CreateDirectory(ProfileDirectory);
FakeCdp.LoggedIn = false;
EmptiedProfiles++;
return Task.CompletedTask;
}
public ValueTask DisposeAsync()
{
Disposed = true;
IsAvailable = false;
return ValueTask.CompletedTask;
}
}
/// <summary>
/// A CDP session answering like a page: frame tree, navigation (with its <c>Page.frameNavigated</c> event, as the
/// collection pipeline hears it), the session cookie (name only).
/// </summary>
internal sealed class FakeCdp : ICdpSession
{
private readonly Lock _gate = new();
private readonly Dictionary<string, List<Action<JsonElement>>> _handlers = new(StringComparer.Ordinal);
public bool LoggedIn { get; set; }
/// <summary>
/// Like the test site, which sets its session cookie on any visit: a navigation to an address starting with this
/// logs in, and the page reports itself loaded. Null: only the test logs in.
/// </summary>
public string? LogsInOnVisit { get; set; }
public string Url { get; private set; } = "about:blank";
public ConcurrentQueue<string> Methods { get; } = new();
/// <summary>The main frame moved to <paramref name="url"/> by itself (a redirect of the site), not by a command.</summary>
public void Navigated(string url)
{
Url = url;
Raise("Page.frameNavigated", new JsonObject { ["frame"] = new JsonObject { ["id"] = "F1", ["url"] = url } });
}
public Task<JsonElement> SendAsync(string method, object? parameters = null, CancellationToken ct = default)
{
CdpCommandPolicy.EnsureAllowed(method);
Methods.Enqueue(method);
JsonNode result = method switch
{
"Page.getFrameTree" => new JsonObject { ["frameTree"] = new JsonObject { ["frame"] = new JsonObject { ["id"] = "F1", ["url"] = Url } } },
"Page.navigate" => Navigate(parameters),
// The session cookie of Instagram, and the test site's one.
"Network.getCookies" => new JsonObject { ["cookies"] = LoggedIn ? new JsonArray(new JsonObject { ["name"] = "sessionid" }, new JsonObject { ["name"] = "sessione_prova" }) : new JsonArray() },
"Runtime.evaluate" when LogsInOnVisit is not null => new JsonObject { ["result"] = new JsonObject { ["type"] = "string", ["value"] = "complete" } },
_ => new JsonObject(),
};
return Task.FromResult(JsonDocument.Parse(result.ToJsonString()).RootElement.Clone());
}
public IDisposable On(string eventName, Action<JsonElement> handler)
{
lock (_gate)
{
if (!_handlers.TryGetValue(eventName, out var list))
{
_handlers[eventName] = list = [];
}
list.Add(handler);
}
return new Removal(() =>
{
lock (_gate)
{
_handlers[eventName].Remove(handler);
}
});
}
private JsonObject Navigate(object? parameters)
{
var url = (parameters as JsonObject)?["url"]?.GetValue<string>();
if (url is not null)
{
if (LogsInOnVisit is { } site && url.StartsWith(site, StringComparison.Ordinal))
{
LoggedIn = true;
}
Navigated(url);
}
return new JsonObject { ["frameId"] = "F1" };
}
private void Raise(string eventName, JsonObject parameters)
{
Action<JsonElement>[] handlers;
lock (_gate)
{
handlers = _handlers.TryGetValue(eventName, out var list) ? [.. list] : [];
}
var element = JsonDocument.Parse(parameters.ToJsonString()).RootElement.Clone();
foreach (var handler in handlers)
{
handler(element);
}
}
private sealed class Removal(Action remove) : IDisposable
{
private Action? _remove = remove;
public void Dispose() => Interlocked.Exchange(ref _remove, null)?.Invoke();
}
}