finos / finos/FDC3

Improve Error Reporting When Desktop Agent *adaptor* Iframe doesn't load

Open
#1,733 6 comments 0 reactions 1 assignee Claimed by @kriswest View on GitHub
bug FDC3 for Web Browsers
Dominant language
TypeScript
Stars
270
Forks
193
Avg merge
2d 13h
Merged PRs (30d)
36

Description

## Minor Issue

Poor error reporting after the initial hello:

```
FDC3 getAgent: Sending hello message to communication iframe
index-DnkoWixp.js:76 FDC3 getAgent: HelloHandler: Sending hello msg:
{
"type": "WCP1Hello",
"meta": {
"connectionAttemptUuid": "126e53f9-3a60-4ded-9580-683f440f0de2",
"timestamp": "2026-01-19T13:34:24.876Z"
},
"payload": {
"channelSelector": true,
"fdc3Version": "2.2",
"resolver": true,
"identityUrl": "https://fdc3.finos.org/toolbox/fdc3-workbench/",
"actualUrl": "https://fdc3.finos.org/toolbox/fdc3-workbench/"
}
}
index-DnkoWixp.js:76 FDC3 getAgent: DesktopAgentPreloadLoader.get(): timeout (1000 ms) at 2026-01-19T13:34:25.845Z
index-DnkoWixp.js:76 FDC3 getAgent: DesktopAgentPreloadLoader: Cleaning up
index-DnkoWixp.js:76 FDC3 getAgent: PostMessageLoader.get(): timeout (1000 ms) at 2026-01-19T13:34:25.845Z
index-DnkoWixp.js:76 FDC3 getAgent: PostMessageLoader: Cleaning up
index-DnkoWixp.js:76 FDC3 getAgent: Discovery results: [
{
"status": "rejected",
"reason": "AgentNotFound"
},
{
"status": "rejected",
"reason": "AgentNotFound"
}
]
```

### Area of Issue

- [ ] App Directory
- [x] API
- [ ] Context Data
- [ ] Intents
- [ ] Desktop Agent Bridging
- [ ] Use Cases
- [x] Other. get-agent

### Issue Description

When connecting to a desktop agent, sometimes CORS can get in the way. For example, this happens when I run Sail on localhost. It tries to load an iframe called embed.html. However, if this fails to load, nothing really shows up in the log.

After digging around, I discovered the error on the network panel, but this isn't ideal:

Image
Image

### Additional Context

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.