docs: File class is not explicitly documented

[KhafraDev]

    Looks like it's not explicitly documented, so I'd be a little hesitant to use it. But maybe that's just a docs fix for undici

Originally posted by @ThisIsMissEm in nodejs/node#45763 (comment)

---

In general, the documentation around fetch could massively be improved. We don't seem to document Headers, Request, Response, FormData, or File.

[ronag]

I think they are sufficiently documented by e.g. MDN? Why duplicate it?

[KhafraDev]

IMO at the very least we should document that they exist in undici and link to MDN. Wdyt?

The main issue in the above comment is that they didn't know File was an undici export because it isn't documented anywhere.

[ThisIsMissEm]

Yeah, just documenting that they exists as exports from import { ... } from "undici"; or require("undici") would make sense, even if that documentation just points to MDN, that'd be good enough for me.

[VedanthB]

Hey, I want to try doing this if it is just a documentation task.

[mcollina]

Yes it is! Just linking to MDN would be fine.

[VedanthB]

Could you please help me by pointing to where exactly in the documentation I need to add a link to the MDN documentation and also the MDN documentation link? @mcollina @ThisIsMissEm

[KhafraDev]

You would need to create a new Fetch.md file https://github.com/nodejs/undici/tree/main/docs/api and update the sidebar https://github.com/nodejs/undici/blob/main/docsify/sidebar.md

• File: https://developer.mozilla.org/en-US/docs/Web/API/File
• FormData: https://developer.mozilla.org/en-US/docs/Web/API/FormData
• Response: https://developer.mozilla.org/en-US/docs/Web/API/Response
• Request: https://developer.mozilla.org/en-US/docs/Web/API/Request
• Headers: https://developer.mozilla.org/en-US/docs/Web/API/Headers

[VedanthB]

So the Fetch.md file would be something like

# Fetch

Undici exposes a fetch() method starts the process of fetching a resource from the network

[File](https://developer.mozilla.org/en-US/docs/Web/API/File)

[FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData)

[Response](https://developer.mozilla.org/en-US/docs/Web/API/Response)

[Request](https://developer.mozilla.org/en-US/docs/Web/API/Request)

[Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers)

And after this, I would need to add the link to the Fetch.d file I just created in the sidebar.md file right? @KhafraDev

[ThisIsMissEm]

@VedanthB you might want to do a subheading for each, with the text "This API is implemented as per the standard, you can find documentation on the [Mozilla Developer Network].”, given each of them are classes that can be instantiated.

[VedanthB]

I have raised a PR, please review it.