NodeJS调用TheCatAPI返回异常数据问题求助

Hey there! Let's sort out this cat API data problem you're having. I've run into similar snags before, so here's what's going wrong and how to fix it:

What's Causing the Problem? #

1. Original Buffer Array Issue: When you pushed chunks into an array and sent it directly with res.send(data), Express was serializing the array of Buffers into that weird {"type": "Buffer", "data": [...]} structure—definitely not the clean JSON you wanted.
2. String Splicing Misstep: When you switched to let data = "" and data += chunk, you converted each Buffer chunk to a string on the fly, but two key things were missing:
   • You didn't explicitly enforce UTF-8 encoding (most APIs use it, but it's safer to lock this in)
   • You sent the raw string without telling Express to treat it as JSON, so browsers/Postman tried parsing it as HTML/XML, hence the syntax error.

The Fixed Code #

Here's the corrected version that'll return the proper structured cat breed JSON:

app.get("/cat-list", (req, res) => {
    const link = `https://api.thecatapi.com/v1/breeds?limit=10&page=0&${process.env.API_KEY}`;

    https.get(link, resp => {
        const chunks = [];

        resp.on('data', chunk => {
            chunks.push(chunk);
        });

        resp.on('end', () => {
            try {
                // Combine all Buffer chunks into one complete Buffer, then decode to UTF-8 string
                const rawJson = Buffer.concat(chunks).toString('utf8');
                // Parse the string into a proper JavaScript object
                const catBreeds = JSON.parse(rawJson);
                // Send the object as JSON (automatically sets correct Content-Type header)
                res.json(catBreeds);
            } catch (error) {
                console.error('Failed to parse cat data:', error);
                res.status(500).send('Oops, something went wrong fetching cat breeds');
            }
        });
    }).on('error', err => {
        console.log('API Request Error: ', err.message);
        res.status(500).send('Failed to connect to the cat API');
    });
});

Why This Works #

• Buffer.concat(chunks): This safely merges all small Buffer pieces into one complete Buffer, avoiding partial character glitches that can happen when concatenating Buffer-to-string chunks directly.
• toString('utf8'): Explicitly decodes the Buffer into a UTF-8 string, matching the API's response encoding.
• JSON.parse(rawJson): Converts the string into a proper JavaScript object, making it easy for Express to serialize correctly.
• res.json(catBreeds): This method does two critical things: it converts the object back to a JSON string, and it sets the Content-Type: application/json response header. This tells Postman and browsers exactly what kind of data they're receiving, so they parse it as JSON instead of trying to read it as XML or HTML.

Quick Pro Tips #

• Always wrap JSON parsing in a try/catch block—if the API returns malformed JSON, your server won't crash, and you can send a friendly error response instead.
• Using template literals for the API link (${process.env.API_KEY}) makes the code cleaner than messy string concatenation.

内容的提问来源于stack exchange，提问作者weak-coder