1
0
mirror of https://github.com/kremalicious/metamask-extension.git synced 2024-11-27 21:00:13 +01:00
metamask-extension/ui/app/hooks/useEthFiatAmount.js
Mark Stacey 14d85b1332
Make JSDoc formatting more consistent (#9796)
A few inconsistencies in JSDoc formatting have been fixed throughout
the project. Many issues remain; these were just the few things that
were easy to fix with a regular expression.

The changes include:

* Using lower-case for primitive types, but capitalizing non-primitive
 types
* Separating the parameter identifier and the description with a dash
* Omitting a dash between the return type and the return description
* Ensuring the parameter type is first and the identifier is second (in
 a few places it was backwards)
* Using square brackets to denote when a parameter is optional, rather
 than putting "(optional)" in the parameter description
* Including a type and identifier with every parameter
* Fixing inconsistent spacing, except where it's used for alignment
* Remove incorrectly formatted `@deprecated` tags that reference non-
 existent properties
* Remove lone comment block without accompanying function

Additionally, one parameter was renamed for clarity.
2020-11-10 14:00:41 -03:30

51 lines
1.8 KiB
JavaScript

import { useMemo } from 'react'
import { useSelector } from 'react-redux'
import {
getConversionRate,
getCurrentCurrency,
getShouldShowFiat,
} from '../selectors'
import { decEthToConvertedCurrency } from '../helpers/utils/conversions.util'
import { formatCurrency } from '../helpers/utils/confirm-tx.util'
/**
* Get an Eth amount converted to fiat and formatted for display
*
* @param {string} [tokenAmount] - The eth amount to convert
* @param {Object} [overrides] - A configuration object that allows the called to explicitly
* ensure fiat is shown even if the property is not set in state.
* @param {boolean} [overrides.showFiat] - If truthy, ensures the fiat value is shown even if the showFiat value from state is falsey
* @param {boolean} hideCurrencySymbol Indicates whether the returned formatted amount should include the trailing currency symbol
* @return {string} - The formatted token amount in the user's chosen fiat currency
*/
export function useEthFiatAmount(
ethAmount,
overrides = {},
hideCurrencySymbol,
) {
const conversionRate = useSelector(getConversionRate)
const currentCurrency = useSelector(getCurrentCurrency)
const userPrefersShownFiat = useSelector(getShouldShowFiat)
const showFiat = overrides.showFiat ?? userPrefersShownFiat
const formattedFiat = useMemo(
() => decEthToConvertedCurrency(ethAmount, currentCurrency, conversionRate),
[conversionRate, currentCurrency, ethAmount],
)
if (
!showFiat ||
currentCurrency.toUpperCase() === 'ETH' ||
conversionRate <= 0 ||
ethAmount === undefined
) {
return undefined
}
return hideCurrencySymbol
? formatCurrency(formattedFiat, currentCurrency)
: `${formatCurrency(
formattedFiat,
currentCurrency,
)} ${currentCurrency.toUpperCase()}`
}