---
title: "`.scrollBy()`"
description: "Прокрутить страницу на указанные величины."
url: "https://doka.guide/js/element-scrollby/"
section: "JavaScript"
createdAt: "2022-10-05"
updatedAt: "2026-11-20"
baseline: [{"group":"scroll-elements","features":["api.Element.scrollBy"]}]
authors: ["starhamster"]
related: ["js/element-scroll", "js/event", "js/events"]
source: "https://github.com/doka-guide/content/blob/main/js/element-scrollby/index.md"
license: "CC BY-NC-SA 4.0"
---

# `.scrollBy()`

## Кратко

Метод `scrollBy()` позволяет программно прокрутить элемент на определённое количество пикселей _относительно текущего положения_.

## Пример

Для скролла внутри элемента (например, в [`<div>`](/html/div/)) нужно сначала получить этот [элемент](/js/element/):

```js
const div = document.querySelector('div')

div.scrollBy(0, 100)
```

<iframe title="Скролл на 100 пикселей" src="https://doka.guide/js/element-scrollby/demos/in-div/" height="450"></iframe>

## Как пишется

```js
window.scrollBy(x, y)
```

Тут _x_ и _y_ — это [координаты](/tools/coordinates/), на которые будет прокручено окно.

Вместо координат в `scrollBy()` можно передать объект с тремя параметрами:

- `top` задаёт количество пикселей для прокрутки по оси _y_;
- `left` — то же самое, но по оси _x_;
- `behavior` определяет поведение прокрутки. По умолчанию резкое `auto`, но можно указать плавный `smooth`.

```js
window.scrollBy({
  top: 100,
  left: 0,
  behavior: 'smooth'
})
```

## Как понять

`scrollBy()` необходим в случае, когда прокрутку нужно совершить относительно текущего положения. В случае прокрутки до определённых координат на экране лучше воспользоваться [`scrollTo()`](/js/element-scrollto/), а в случае прокрутки до конкретного элемента — методом [`scrollIntoView()`](/js/element-scrollintoview/).

