Why CORS matters for APIs in Express

Introduction

CORS helps control who can use your API from other websites. It keeps your API safe by blocking unwanted access.

When your API is accessed by web pages from different websites.

When you want to allow only certain websites to use your API.

When browsers block your API requests due to security rules.

When building public APIs that many websites can use safely.

When debugging why your web app can't get data from your API.

Syntax

Express

const cors = require('cors');
const express = require('express');
const app = express();
app.use(cors({ origin: 'https://example.com' }));

Use the 'cors' middleware in Express to set CORS rules easily.

The 'origin' option controls which websites can access your API.

Examples

Allows all websites to access your API (open to everyone).

Express

app.use(cors());

Only allows requests from 'https://mywebsite.com'.

Express

app.use(cors({ origin: 'https://mywebsite.com' }));

Allows multiple specific websites to access your API.

Express

app.use(cors({ origin: ['https://site1.com', 'https://site2.com'] }));

Sample Program

This Express API uses CORS to allow only requests from 'https://myfrontend.com'. Other websites will be blocked by the browser.

Express

import express from 'express';
import cors from 'cors';

const app = express();

// Allow only https://myfrontend.com to access this API
app.use(cors({ origin: 'https://myfrontend.com' }));

app.get('/data', (req, res) => {
  res.json({ message: 'Hello from API!' });
});

app.listen(3000, () => {
  console.log('API running on http://localhost:3000');
});

Important Notes

CORS is enforced by browsers, not by the server itself.

Without proper CORS, your API might be blocked when called from web pages on other domains.

Always set CORS rules carefully to balance security and usability.

Summary

CORS controls which websites can use your API.

It protects your API from unwanted access by other sites.

Express makes it easy to set CORS rules with middleware.

Practice

1. What is the main reason CORS is important for APIs in Express?

easy

A. It encrypts the data sent by the API.

B. It speeds up the API response time.

C. It automatically logs all API requests.

D. It controls which websites can access your API to protect it.

Solution

1. Step 1: Understand CORS purpose

   CORS stands for Cross-Origin Resource Sharing and it controls which websites can call your API.

2. Step 2: Identify protection role

   By controlling access, CORS protects your API from unwanted or malicious websites.

3. Final Answer:

   It controls which websites can access your API to protect it. -> Option D

4. Quick Check:

   CORS controls access = D [OK]

Hint: Remember: CORS controls access, not speed or encryption [OK]

Common Mistakes:

• Thinking CORS speeds up API
• Confusing CORS with logging
• Believing CORS encrypts data

2. Which Express middleware is commonly used to enable CORS?

easy

A. cors

B. express-session

C. body-parser

D. morgan

Solution

1. Step 1: Recall Express middleware for CORS

   The npm package named 'cors' is the standard middleware to enable CORS in Express.

2. Step 2: Identify other middleware roles

   express-session manages sessions, body-parser parses request bodies, morgan logs requests, none handle CORS.

3. Final Answer:

   cors -> Option A

4. Quick Check:

   Enable CORS with 'cors' middleware = B [OK]

Hint: Use 'cors' package to enable CORS in Express apps [OK]

Common Mistakes:

• Choosing body-parser for CORS
• Confusing logging middleware with CORS
• Using session middleware for CORS

3. What will happen if an API does NOT set CORS headers and a browser tries to call it from another website?

medium

A. The browser will block the request due to CORS policy.

B. The API will respond faster without CORS headers.

C. The API will automatically allow all websites.

D. The browser will ignore CORS and allow the request.

Solution

1. Step 1: Understand browser CORS enforcement

   Browsers enforce CORS by blocking cross-origin requests if the server does not send proper CORS headers.

2. Step 2: Identify consequences of missing CORS headers

   Without CORS headers, the browser blocks the request; the API itself may respond but browser denies access.

3. Final Answer:

   The browser will block the request due to CORS policy. -> Option A

4. Quick Check:

   Missing CORS headers = browser blocks request = A [OK]

Hint: No CORS headers means browser blocks cross-site calls [OK]

Common Mistakes:

• Thinking API blocks request instead of browser
• Assuming API allows all without CORS
• Believing browser ignores CORS

4. Consider this Express code snippet:

const express = require('express');
const app = express();

app.get('/data', (req, res) => {
  res.json({ message: 'Hello' });
});

app.listen(3000);

What is missing to allow cross-origin requests safely?

medium

A. Adding a body-parser middleware.

B. Changing app.get to app.post.

C. Adding CORS middleware to set proper headers.

D. Using HTTPS instead of HTTP.

Solution

1. Step 1: Identify missing CORS headers

   The code does not include any middleware to set CORS headers, so cross-origin requests will be blocked by browsers.

2. Step 2: Recognize correct fix

   Adding CORS middleware (like 'cors' package) will add headers to allow safe cross-origin requests.

3. Final Answer:

   Adding CORS middleware to set proper headers. -> Option C

4. Quick Check:

   Add CORS middleware to allow cross-origin = A [OK]

Hint: Add 'cors' middleware to fix cross-origin blocking [OK]

Common Mistakes:

• Thinking HTTP method change fixes CORS
• Confusing body parsing with CORS
• Believing HTTPS alone solves CORS

5. You want your Express API to allow only requests from https://example.com but block others. Which CORS configuration achieves this?

hard

A. app.use(cors());

B. app.use(cors({ origin: 'https://example.com' }));

C. app.use(cors({ origin: '*' }));

D. app.use(cors({ methods: ['GET', 'POST'] }));

Solution

1. Step 1: Understand origin option in CORS

   The 'origin' option in the cors middleware specifies which website origins are allowed to access the API.

2. Step 2: Match requirement to configuration

   Setting origin to 'https://example.com' allows only that site; '*' allows all, no origin restricts, methods restrict HTTP verbs only.

3. Final Answer:

   app.use(cors({ origin: 'https://example.com' })); -> Option B

4. Quick Check:

   Restrict origin to example.com = C [OK]

Hint: Set origin to specific URL to restrict access [OK]

Common Mistakes:

• Using '*' allows all origins, not restricted
• Omitting origin allows all by default
• Confusing methods with origin restriction