mirror of
https://github.com/angular/angular.git
synced 2026-09-14 13:54:52 +08:00
Ward Bell
8ef5cc680d
**Unit Testing Code Does Not Compile** The compilation error is: ``` The compilation error is ./src/testing/http-client.spec.ts - Error: Module build failed (from ./node_modules/@ngtools/webpack/src/ivy/index.js): Error: /home/projects/obk3vc--run/src/testing/http-client.spec.ts is missing from the TypeScript compilation. Please make sure it is in your tsconfig via the 'files' or 'include' property. ``` I’m not sure what to say about unit testing HTTP in a full Standalone app. Is it different? _This is the only known remaining defect in this conversion of HTTP to Standalone._ **Edited content of `http-request-data-from-server.md`** The current version of this page is confusing. In particular * It tells readers they **should always unsubscribe** from the HttpClient method calls. This is *not true* and this example doesn't even do it. I replaced this instruction with more nuanced advice and an explanation of why it is OK to not unsubscribe to HttpClient methods. * There is a "helpful" note about using the RxJS `map` operator to transform the response. This is *not "helpfulf"*. It is *confusing* because the sample doesn't use `map` anywhere. It was unnecessary here, even if it might be helpful elsewhere. I removed this note. * The "Requesting a typed response" section seemed unclear to me, particularly because the guide begins with a `get` request that already has the `Config` return type specification. My revision attempts to make this more clear. * The bold "callout" about the `observe` and `responseType` options appears out of nowhere after "Requesting a typed response". It's disconcerting at best. I moved it to the bottom of the page and linked to it from the `options` discussion at the top. I made a few other revisions that I hope improve the readability of this page. **Corrected `http-make-jsonp-request.md`** The JSONP example, handwritten in the guide page, would not have compiled. I added one that does to `heroes.service.ts` and displayed it on this page. **Corrected `http-handle-request-errors.md` This page ended with a section called "Sending data to a server" that introduces PUT, POST, and DELETE. These features have nothing to do with error handling and the verbiage here duplicates the opening paragraphs of the next topic which does: "Send data to a server". So I deleted this section from the error handling guide page. **Archived http-setup-server-communication.md** `http-setup-server-communication.md` appears to be the original long document that has since been divided over the other pages in this folder. It shouldn’t be in the reader’s flow. I did update it for Standalone. But I also removed it from left-nav and marked as archived. PR Close #51400
29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
# Understanding communicating with backend services using HTTP
|
|
|
|
Most front-end applications need to communicate with a server over the HTTP protocol, to download or upload data and access other back-end services. Angular provides a client HTTP API for Angular applications, the `HttpClient` service class in `@angular/common/http`.
|
|
|
|
## Prerequisites
|
|
|
|
Before working with the `HttpClientModule`, you should have a basic understanding of the following:
|
|
|
|
* TypeScript programming
|
|
* Usage of the HTTP protocol
|
|
* Angular application-design fundamentals, as described in [Angular Concepts](guide/architecture)
|
|
* Observable techniques and operators.
|
|
See the [Observables guide](guide/observables).
|
|
|
|
## HTTP client service features
|
|
|
|
The HTTP client service offers the following major features.
|
|
|
|
* The ability to request [typed response objects](guide/http-request-data-from-server)
|
|
* Streamlined [error handling](guide/http-handle-request-errors)
|
|
* [Testability](guide/http-test-requests) features
|
|
* Request and response [interception](guide/http-intercept-requests-and-responses)
|
|
|
|
## What's next
|
|
|
|
* [Setup for server communication](guide/http-setup-server-communication)
|
|
|
|
@reviewed 2023-08-16
|