calculatediscount v1.0.3
calculateDiscount Function Documentation
Introduction
The calculateDiscount
function is a utility function that calculates the discounted amount for a given baseAmount
. It allows you to apply discounts based on different discount rates and conditions. The function returns a promise that resolves to the discounted amount.
Function Signature
const calculateDiscount = (baseAmount, initialDiscount, mutatedDiscount, prop) => {
// Function body
}
Parameters
baseAmount
: The initial amount for which the discount is to be applied.initialDiscount
: An object representing the initial discount rate.mutatedDiscount
: An object representing a mutated discount rate.prop
: A boolean value indicating whether the initial discount should be considered.
Function Logic
The
discountRate
is determined based on different conditions:If the
prop
parameter istrue
, the initial discount is considered. It checks if theinitialDiscount.discount
exists and is of length 2. If so, it sets the discount rate to '0'; otherwise, it uses the provided discount value (parsed as a float). If theinitialDiscount
does not exist, the discount rate is set to 0.If the
prop
parameter isfalse
or not provided, it uses themutatedDiscount.discount
value as the discount rate (parsed as a float). IfmutatedDiscount.discount
does not exist, the discount rate is set to 0.
The
discountedAmount
is calculated by subtracting the discount rate from thebaseAmount
.The function returns a promise that resolves to the
discountedAmount
.
Usage Example
import calculateDiscount from './calculateDiscount';
// Sample usage with different discount scenarios
const baseAmount = 100; // Initial amount
const initialDiscount = { discount: '10' }; // Initial discount rate
const mutatedDiscount = { discount: '5' }; // Mutated discount rate
const prop = true; // Consider initial discount
// Calculate the discounted amount using the calculateDiscount function
calculateDiscount(baseAmount, initialDiscount, mutatedDiscount, prop)
.then(discountedAmount => {
console.log(`Discounted Amount: $${discountedAmount.toFixed(2)}`);
});
GitHub Repository
- The source code for this function is available in the calculateDiscount GitHub repository.
Notes
This function provides flexibility in applying discounts based on different conditions and sources.
It can be used to calculate discounted prices in various scenarios, making it a versatile utility for discount calculations.
This Markdown documentation provides a detailed explanation of the calculateDiscount
function, its parameters, and how it performs the discount calculation. It also includes a usage example and a link to the GitHub repository for reference.