Common Mistakes

1. Trying to Use catch()

Because BoltFetch internalizes promise rejection for HTTP errors, calling .catch() only triggers on critical network failures (like physical disconnection), not 4xx or 5xx warnings. Always check !res.success instead.

2. Double Stringifying JSON

Do not do body: JSON.stringify({ a: 1 }). BoltFetch does this for you automatically. Just pass the raw object: body: { a: 1 }.

3. Missing Content-Type for Edge Cases

If you specify a responseType: 'Text', ensure you handle the text format properly in the response, rather than expecting an object to be typed automatically.