feat: support interceptors arrays

[antoinerey]

🔗 Linked issue

None.

❓ Type of change

• 📖 Documentation (updates to the documentation, readme, or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

This commit allows passing interceptors as single functions (current behaviour), or arrays of functions (new behaviour). This makes it much easier to execute multiple functions on the consumer side. The alternative would be to compose all functions into one, but that's more complicated in my opinion.

With this change, the following becomes possible.

$fetch('/api/endpoint', {
  onRequest: [
    () => { /* Do something */ },
    () => { /* Do something else */ },
  ],
  onResponse: [
    () => { /* Do something */ },
    () => { /* Do something else */ },
  ],
})

Note that calling $fetch.create() and then passing interceptors when calling $fetch() will keep overriding the interceptors as the current behaviour. I did not want to go too much into there as I'm not sure what would be the expected behaviour. Plus, continuing to override the interceptors means that this PR is not a breaking change.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[antoinerey]

Friendly ping. 🤗 Is there anything I can do to make this PR move forward?

[enkot]

@antoinerey @pi0
I think it might be a better alternative to my PR (#357)
If we treat interceptors as an array, we can allow merging arrays from $fetch and $fetch.create. So that interceptors from $fetch and $fetch.create can be enforced to append or prepend to the resulting array of interceptors (similar to Nuxt plugins):

const $myFetch = $fetch.create({
  onRequest: [
    (ctx) => { /* Handler 1 */ }, // same as "enforce: 'default'"
    {
      enforce: 'post',
      handler: (ctx) => { /* Handler 2 */ }
    }
  ]
})

$myFetch({
  onRequest: [
    // Will be appended 
    (ctx) => { /* Handler 3 */ },
    // If you need to prepend in some scenarios
    {
      enforce: 'pre',
      handler: (ctx) => { /* Handler 4 */ }
    }
  ]
})

// Interceptors will be executed in this order:
/*
Handler 4
Handler 1
Handler 3
Handler 2
*/

Now I don't like my PR anymore 😅

[codecov]

Codecov Report

Attention: Patch coverage is 85.18519% with 4 lines in your changes missing coverage. Please review.

Project coverage is 69.13%. Comparing base (27996d3) to head (60bdd98).
Report is 37 commits behind head on main.

Files	Patch %	Lines
src/fetch.ts	69.23%	4 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##             main     #353       +/-   ##
===========================================
+ Coverage   56.86%   69.13%   +12.27%     
===========================================
  Files          16       16               
  Lines         728      499      -229     
  Branches      113      119        +6     
===========================================
- Hits          414      345       -69     
+ Misses        303      144      -159     
+ Partials       11       10        -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[pi0]

Thanks for the nice PR and tests dear @antoinerey ❤️

i finally had a chance to check on it and pushed couple of improvement refactors.