Beheers Cursor voor Geautomatiseerde Code Documentatie
description
Maakt het sneller aanmaken van hoogwaardige documentatie direct vanuit code mogelijk, vermindert handmatig werk en verbetert de onderhoudbaarheid van code. Deze prompt helpt je Cursor te benutten voor begrijpelijke documentatie op maat van je taal en project, waardoor je tijd bespaart en consistentie waarborgt.
prompt
Help me met het genereren van gedetailleerde en precieze documentatie voor mijn code met Cursor. Mijn programmeertaal: <voer je programmeertaal in>. De code of module ...
try_prompt
generate_helper
disclaimerOnPageApi
tags
ai_answers
provider: openai
model: gpt-4.1-nano
Natuurlijk! Hier is een gedetailleerde en precieze documentatie voor jouw JavaScript-functie `calculateTotal`:
/**
* Berekent het totale bedrag van een lijst met items.
*
* Deze functie neemt een array van objecten, waarbij elk object een 'price'-eigenschap bevat,
* en retourneert de som van alle prijzen.
*
* @param {Array<Object>} items - Een array van objecten, elk met een 'price' eigenschap die een getal is.
* Bijvoorbeeld: [{ name: 'item1', price: 10 }, { name: 'item2', price: 15 }]
*
* @returns {number} - Het totale bedrag, als som van alle 'price'-waarden in de array.
*
* @example
* const shoppingItems = [
* { name: 'Boek', price: 12.99 },
* { name: 'Pen', price: 1.50 },
* { name: 'Notitieboek', price: 5.75 }
* ];
* const totaal = calculateTotal(shoppingItems);
* console.log(totaal); // Output: 20.24
*/
function calculateTotal(items) {
return items.reduce((total, item) => total + item.price, 0);
}
**Uitleg:**
- **Functionaliteit:**
De functie `calculateTotal` berekent de som van de `price`-eigenschappen van alle objecten in de meegeleverde array `items`.
- **Parameters:**
- `items`: Een array van objecten. Elk object moet minimaal een `price` eigenschap bevatten die een numerieke waarde vertegenwoordigt.
- **Retourwaarde:**
- Een getal dat de totale som van alle prijzen in de array is.
- **Gebruik:**
- De functie wordt aangeroepen met een array van objecten. Het resultaat is het totaalbedrag dat je bijvoorbeeld kunt gebruiken voor facturering, overzicht of verdere berekeningen.
Heeft u nog verdere wensen of voorbeelden die ik kan toevoegen?
provider: deepseek
model: deepseek-chat
Zeker, hier is gedetailleerde documentatie voor je JavaScript functie:
## Functie: calculateTotal
### Functionaliteit
Deze functie berekent de totale prijs van alle items in een array door de prijzen van alle individuele items bij elkaar op te tellen. Het maakt gebruik van de `Array.reduce()` methode om door de array te itereren en een cumulatieve som te berekenen.
### Parameters
- **items** (Array): Een array van objecten waarbij elk object een `price` eigenschap moet bevatten
- Type: Array van objecten
- Vereiste eigenschap: Elk object moet een `price` property hebben (nummer)
- Voorbeeld: `[{price: 10}, {price: 20}, {price: 15}]`
### Retourwaarde
- **total** (Number): De som van alle prijzen in de items array
- Type: Number
- Retourneert `0` wanneer de array leeg is
- Retourneert de totale som wanneer items aanwezig zijn
### Gebruiksvoorbeelden
```javascript
// Voorbeeld 1: Basis gebruik
const shoppingCart = [
{name: "Boek", price: 25},
{name: "Pen", price: 2},
{name: "Notitieboek", price: 15}
];
const totaalBedrag = calculateTotal(shoppingCart);
console.log(totaalBedrag); // Output: 42
// Voorbeeld 2: Lege array
const legeWinkelwagen = [];
const totaalLeeg = calculateTotal(legeWinkelwagen);
console.log(totaalLeeg); // Output: 0
// Voorbeeld 3: Enkel item
const enkelItem = [{name: "Fiets", price: 299}];
const totaalEnkel = calculateTotal(enkelItem);
console.log(totaalEnkel); // Output: 299
```
### Opmerkingen
- De functie verwacht dat elk item object een `price` property heeft
- Als een item geen `price` property heeft, wordt `NaN` geretourneerd
- De functie is puur en heeft geen side-effects
- Werkt optimaal voor e-commerce winkelwagens, facturatiesystemen, en prijsberekeningen