getStaticProps
nos funciona cuando requerimos que nuestra aplicacion sea SEO friendly. Dado que los SPA o client-side rendering no generan contenido, esta tecnica nos ayuda a que nuestro sitio en Next.js sea encontrado por Google.
Transformar la estrategia de obtención de datos en una aplicación Next.js puede marcar una diferencia enorme en rendimiento y SEO. getStaticProps es uno de los métodos más poderosos del framework, y entender cómo funciona permite generar páginas con HTML prerenderizado desde el servidor, en lugar de depender exclusivamente del navegador.
¿Cómo funciona getStaticProps para renderizar en el servidor?
Cuando se trabaja con fetching en el cliente, la información se obtiene mediante un useEffect que se ejecuta en el navegador. Esto significa que el HTML inicial llega vacío y el contenido se carga después. Con getStaticProps, el enfoque cambia por completo: los datos se obtienen en el servidor durante el proceso de construcción y se inyectan como props al componente [01:00].
El procedimiento es directo:
Esta función debe ser async, ya que realiza operaciones asíncronas como llamadas a una API. Al final, retorna un objeto con la propiedad props, que contiene exactamente lo que el componente necesita para renderizarse [01:30].
typescript export const getStaticProps: GetStaticProps<HomeProps> = async () => { const plants = await getPlants({ limit: 10 })
return { props: { plants, }, } }
Un detalle importante: getStaticProps solo funciona en archivos dentro de la carpeta pages de Next.js. No se puede usar en componentes regulares ni en archivos fuera de esa estructura.
¿Cómo tipar getStaticProps con TypeScript?
Cuando se trabaja con TypeScript, Next.js ofrece dos tipos utilitarios que facilitan la anotación correcta [02:40].
typescript import { GetStaticProps, InferGetStaticPropsType } from 'next'
type HomeProps = { plants: Plant[] }
export const getStaticProps: GetStaticProps<HomeProps> = async () => { const plants = await getPlants({ limit: 10 }) return { props: { plants } } }
function Home({ plants }: InferGetStaticPropsType<typeof getStaticProps>) { // plants es Plant[] }
De esta forma, TypeScript sabe que plants es un array de tipo Plant sin necesidad de anotaciones manuales adicionales en el componente.
¿Qué diferencia real hay entre renderizado en cliente y servidor?
La prueba más contundente está en el page source del navegador [04:00]. Cuando se usa useEffect para traer datos, al inspeccionar el código fuente HTML no se encuentra el contenido dinámico. Chrome confirma que términos como "watering" o "houseplants" simplemente no existen en el HTML inicial.
En cambio, con getStaticProps, ese mismo contenido ya viene incluido en el HTML que el servidor entrega. Esto tiene consecuencias directas:
¿Cómo extender este patrón a otros datos como autores y categorías?
El mismo enfoque se aplica a cualquier tipo de dato disponible en la API [06:10]. Los métodos auxiliares como getAuthorList o las funciones para categorías ya están preparados en el archivo api/index.ts. Se pueden incorporar dentro de getStaticProps para alimentar componentes como Hero, PlantCollection con variaciones de layout, o un componente de autores.
¿Qué papel juegan los custom hooks en el fetching desde cliente?
Para datos que aún se obtienen en el navegador, se puede construir un custom hook que maneje dos estados: el status de la petición HTTP y el dato obtenido [07:00]. El patrón incluye un useEffect que ejecuta la llamada a la API, guarda la respuesta en el estado y actualiza el status a success. El componente consumidor simplemente verifica data y status para decidir qué renderizar.
Este contraste entre fetching en servidor con getStaticProps y fetching en cliente con hooks es fundamental para decidir la estrategia adecuada según cada caso. ¿Ya probaste mover tus propios datos al servidor? Comparte tu experiencia en los comentarios.
Transformar la estrategia de obtención de datos en una aplicación Next.js puede marcar una diferencia enorme en rendimiento y SEO. getStaticProps es uno de los métodos más poderosos del framework, y entender cómo funciona permite generar páginas con HTML prerenderizado desde el servidor, en lugar de depender exclusivamente del navegador.
Cuando se trabaja con fetching en el cliente, la información se obtiene mediante un useEffect que se ejecuta en el navegador. Esto significa que el HTML inicial llega vacío y el contenido se carga después. Con getStaticProps, el enfoque cambia por completo: los datos se obtienen en el servidor durante el proceso de construcción y se inyectan como props al componente [01:00].
El procedimiento es directo:
Esta función debe ser async, ya que realiza operaciones asíncronas como llamadas a una API. Al final, retorna un objeto con la propiedad props, que contiene exactamente lo que el componente necesita para renderizarse [01:30].
typescript export const getStaticProps: GetStaticProps<HomeProps> = async () => { const plants = await getPlants({ limit: 10 })
return { props: { plants, }, } }
Un detalle importante: getStaticProps solo funciona en archivos dentro de la carpeta pages de Next.js. No se puede usar en componentes regulares ni en archivos fuera de esa estructura.
Cuando se trabaja con TypeScript, Next.js ofrece dos tipos utilitarios que facilitan la anotación correcta [02:40].
typescript import { GetStaticProps, InferGetStaticPropsType } from 'next'
type HomeProps = { plants: Plant[] }
export const getStaticProps: GetStaticProps<HomeProps> = async () => { const plants = await getPlants({ limit: 10 }) return { props: { plants } } }
function Home({ plants }: InferGetStaticPropsType<typeof getStaticProps>) { // plants es Plant[] }
De esta forma, TypeScript sabe que plants es un array de tipo Plant sin necesidad de anotaciones manuales adicionales en el componente.
La prueba más contundente está en el page source del navegador [04:00]. Cuando se usa useEffect para traer datos, al inspeccionar el código fuente HTML no se encuentra el contenido dinámico. Chrome confirma que términos como "watering" o "houseplants" simplemente no existen en el HTML inicial.
En cambio, con getStaticProps, ese mismo contenido ya viene incluido en el HTML que el servidor entrega. Esto tiene consecuencias directas:
El mismo enfoque se aplica a cualquier tipo de dato disponible en la API [06:10]. Los métodos auxiliares como getAuthorList o las funciones para categorías ya están preparados en el archivo api/index.ts. Se pueden incorporar dentro de getStaticProps para alimentar componentes como Hero, PlantCollection con variaciones de layout, o un componente de autores.
Para datos que aún se obtienen en el navegador, se puede construir un custom hook que maneje dos estados: el status de la petición HTTP y el dato obtenido [07:00]. El patrón incluye un useEffect que ejecuta la llamada a la API, guarda la respuesta en el estado y actualiza el status a success. El componente consumidor simplemente verifica data y status para decidir qué renderizar.
Este contraste entre fetching en servidor con getStaticProps y fetching en cliente con hooks es fundamental para decidir la estrategia adecuada según cada caso. ¿Ya probaste mover tus propios datos al servidor? Comparte tu experiencia en los comentarios.
getStaticProps
nos funciona cuando requerimos que nuestra aplicacion sea SEO friendly. Dado que los SPA o client-side rendering no generan contenido, esta tecnica nos ayuda a que nuestro sitio en Next.js sea encontrado por Google.
Recuerden importar GetStaticProps y InferGetStaticPropsType desde Next
¿GetStaticProps, InferGetStaticPropsType entonces no son necesarios si no se trabaja con typescript?
GetStaticProps recupera una sola vez la data, durante la compilación? En que casos se puede utilizar?
Lo que se me dificulta con Typescript es que no sé que types hay para tipar mi componente y a veces hago interfaces o types propios solo para que el linter no me notifique de un error. Cómo puedo mejorar en esa parte?
Explicación del código
// Estas son las importaciones de los diferentes componentes y funciones que se utilizarán en el archivo.
import { Layout } from '@components/Layout'
import { getPlantList } from '@api/index'
import { PlantCollection } from '@components/PlantCollection'
import { GetStaticProps , InferGetStaticPropsType } from 'next'
import { Hero } from '@components/Hero'
import { Authors } from '@components/Authors'
// Aquí estás definiendo un tipo para los props de tu página de inicio.
// De acuerdo con este tipo, espera recibir un arreglo de plantas.
type HomeProps = { plants:Plant[]}
// La función getStaticProps es una característica de Next.js que te permite pre-renderizar tu página en el momento de la construcción.
// En este caso, estás obteniendo una lista de plantas de tu API y pasándolas como props a tu componente de página de inicio.
export const getStaticProps: GetStaticProps<HomeProps> = async () => {
const plants = await getPlantList({limit:10})
return{
props: {
plants
}
}
}
// Este es el componente de tu página de inicio.
// Recibe las plantas como props debido a la función getStaticProps que definiste anteriormente.
export default function Home({plants}: InferGetStaticPropsType<typeof getStaticProps>) {
return (
// Estás envolviendo todo tu contenido de la página de inicio en un componente Layout.
<Layout>
// El componente Hero recibe la primera planta de tu lista de plantas como props. Le estás dando una margen inferior con la clase 'mb-20'.
<Hero {...plants[0]} className='mb-20' />
// El componente Authors es mostrado a continuación, también con un margen inferior definido.
<Authors className='mb-10' />
// El componente PlantCollection se usa para mostrar tus plantas. Primero, muestras las plantas de la posición 1 a la 3 en forma vertical con un margen inferior.
<PlantCollection plants={plants.slice(1,3)} variant='vertical' className='mb-24'/>
// Luego, si tienes más de 8 plantas, muestras las plantas de la posición 3 a la 9 en forma cuadrada. Si tienes menos de 8, muestras todas las plantas restantes.
<PlantCollection
plants={plants.length > 8 ? plants.slice(3,9) : plants}
variant='square'
/>
</Layout>
)
}
Al hacer el cambio de CSR a SSR debemos utilizar la funcion getStaticProps y retornar los props con la informacion necesaria para pasarle a la pagina.
Para mejorar la experiencia de desarrollo es útil hacer uso de los tipos GetStaticProps e InferGetStaticPropsType(importados desde next) cuya funcion es tipar la informacion enviada desde el servidor y el cliente.
Utilizamos SSG
import { GetStaticProps, InferGetStaticPropsType } from 'next'
import { Layout } from '@components/Layout'
import { getPlantList } from '@api'
import { Hero } from '@components/Hero'
import { PlantCollection } from '@components/PlantCollection'
import { Authors } from '@components/Authors'
type HomeProps = {
plants: Plant[]
}
export const getStaticProps: GetStaticProps<HomeProps> = async () => {
const plants = await getPlantList({ limit: 10 })
return {
props: { plants },
revalidate: 5 * 60, // once every five minutes
}
}
export default function Home({
plants,
}: InferGetStaticPropsType<typeof getStaticProps>) {
return (
<Layout>
<Hero {...plants[0]} className="mb-20" />
<Authors className="mb-10" />
<PlantCollection
plants={plants.slice(1, 3)}
variant="vertical"
className="mb-24"
/>
<PlantCollection
plants={plants.length > 8 ? plants.slice(3, 9) : plants}
variant="square"
/>
</Layout>
)
}
Utilizamos Client Sire Rendering
import { useEffect, useState } from 'react'
import Link from 'next/link'
import { getAuthorList, QueryStatus } from '@api'
import { Grid } from '@ui/Grid'
import { Typography } from '@ui/Typography'
type AuthorProps = {
className?: string
}
export function Authors({ className }: AuthorProps) {
const { data, status } = useAuthors()
if (data == null || status !== 'success') {
const dummyItems = Array.from({ length: 4 }, (_, i) => `item-${i}`)
return (
<Grid container spacing={4} className={className} justify="center">
{dummyItems.map((item) => (
<Grid
xs={2}
item
key={item}
className="bg-gray-200 animate pulse"
></Grid>
))}
</Grid>
)
}
return (
<Grid container spacing={4} className={className} justify="center">
{data.map(({ id, photo, fullName, handle }) => (
<Grid item key={id}>
<Link href={`/top-stories/${handle}`}>
<a title={`See latest stories from ${fullName}`}>
<img src={photo.url} width={150} />
<Typography variant="h5" component="p">
{fullName}
</Typography>
</a>
</Link>
</Grid>
))}
</Grid>
)
}
function useAuthors() {
const [status, setStatus] = useState<QueryStatus>('idle')
const [data, setData] = useState<Author[] | null>(null)
useEffect(
() => {
setStatus('loading')
getAuthorList({ limit: 10 })
.then((returnedData) => {
setData(returnedData)
setStatus('success')
})
.catch(() => setStatus('error'))
},
[
// Run effect once
]
)
return {
status,
data,
}
}